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PUBLIC DOMAIN SOFTWARE 


We launched our own Public Domain Software 
Library in December 1990 with just 12 discs 
packed with files covering applications, utilities, 
clipart, games and much more besides. Since 
then our library has grown to some 50 discs 
offering a wide variety of subject matter at low 
prices. 


The philosophy behind public domain software 
is that authors allow their software to be 
distributed without restriction provided that any 
charges which are made are there solely to 
cover duplication and distribution costs. 
Unfortunately, VAT registered companies like 


RISC Developments have also to include VAT as__ 


well which pushes up the price. 


We have now managed to cover the majority of 
our start-up costs, and have reappraised our 
‘costings. We have also taken note of the fact 
that the majority of orders for PD discs 
accompany orders for other products which has 
a beneficial effect on our post and packing 
costs, As a consequence we have been able to 
make a dramatic reduction in the price of all the 
discs in our PD library. With immediate effect, 
all RISC User PD discs will be priced at £1.60 per 
disc, with no extra charges if you order by post. 
And that price includes the VAT. 


We would also like to expand and update our 
Public Domain Software Library, so if you have 
any suitable software then please submit it for 
consideration. Do make sure that what you 
send is legitimate public domain software (see 
last month's editorial). Only the author (or 
copyright holder) can can make this assertion. 


If you already have some of our PD discs, then 
why not take a fresh look at what is on offer. If 


you have not been tempted previously, then 
there cannot be a better time than now to try 
out a disc or two. We will also be looking to 
add some new releases in the next issue of RISC 
User. 


READER PARTICIPATION 


We have been giving much thought in recent 
months to the future content of RISC User and 
the ways in which it might be improved to 
better meet readers needs. As always we have 
tried, as far as possible, to take into account the 
views of both members and non-members to 
ensure that we understand the needs of 
readers. 


Some changes have already been made - 
witness the increased news coverage and 
revised layout of these pages. We have also 
endeavoured to increase the number of reviews 
in each issue, and to provide better information 
on products. 


Starting from the next issue of RISC User we 
shall be expanding and revising our Postbag 
pages under a new name. This area will be 
devoted to readers’ comments and views, plus 
useful information. We want to see these pages 
being used much more as a forum within which 
readers can exchange information, seek 
solutions to their problems (using a new 
Noticeboard feature), and generally use these 
pages as a monthly bulletin board. 


So, we hope to receive a bumper crop of letters 
in the next few weeks. If you have any 
comments on the current Acorn/Archimedes 
scene, information to impart, or problems 
needing an answer, why not drop us a line? 
M.W. 
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FUN SCHOOL 4 ARRIVES 


The award winning series Fun School is 
expanding to include an Archimedes version 
of Fun School 4. With popular characters 
Teddy and Freddy the Frog, now joined by 
Sammy the Spy, Teddy returns in Reeboks 
and baseball cap with six brand new 
educational games covering art, maths, 
words, karaoke and more. Freddy the Frog 
hits the streets with skateboard in hand ready 
to astound 5-7 year olds with sequences in 
maths, word sorting and keyboarding. 
Sammy the Spy replaces Robbie the Robot for 
8 to 11 year olds, and zips around the world 
for geography and history lessons plus maths, 
general knowledge and timetable programs. 
Fun School 4 costs £24.99 for each age group, 
and is published by Europress Software, 
Europa House, Adlington Park, Macclesfield 
SK10 4NP. Fun School 4 is available through 
all good dealers including Beebug. 


DTP FOR ALL 


Desktop Publishing on the Archimedes is the title of a new book by Bruce Goatly, 
just published by Sigma Press for £12.95. The book, containing over 300 pages, 
ranges widely, covering both the 
principles and practice of DTP in 
general, with more specific information 
relating to commercial word processing 
and DTP applications available on the 
Arc. There is even a chapter on ‘Budget 
DTP” using Edit and Draw. 


Not to be outdone, Dabs Press has also 
brought out a new book entitled Budget 
DTP on the Acorn Archimedes written by 
Roger Amos and priced at £12.95. As the 
name suggests this book is about using 
software supplied with every 
Archimedes in the form of Draw, Edit 
and Paint. There are also chapters 
covering fonts and the use of printers, 
plus helpful information on page layout 
and advice on trouble-shooting. 


Publishing 
on the 


DTP on the Archimedes and Budget DTP should both be available through 
bookshops and computer dealers, and can be obtained from Beebug. 


ACORN PC EMULATOR 


Following our last report on upgrading to the latest version of Acorn’s PC 
Emulator (News, RISC User Volume 5 Issue 3), matters do not seem to have 
progressed smoothly, at least for some users. The problems seem to revolve 
around poor communication between Acorn Computers and Acorn Direct, and 
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lack of sufficient supplies of the upgrade. Further supplies were expected to be 
delivered by Acorn mid-February, and all outstanding orders should have been 
fulfilled by the time you read this. Our own coverage was also confusing: the 
product code for the DR DOS upgrade is AKA45, and for the MS-DOS upgrade 
AKA48. Closing date for upgrades is 27th March 1992. Acorn Direct (also 
known as Vector Marketing) is at 13 Dennington Road, Wellingborough, 
Northants NN8 2RL. Refer to the previous news item for further details. 


DICTIONARY OF THE LIVING WORLD 


Media Design Interactive has announced an Archimedes version of its 
Dictionary of the Living World CD-ROM. This contains more than 2500 text 
entries supplemented with over 1000 pictures, 100 animal sounds, and 100 
animation and full motion video clips. Aimed at children from the age of 10 
upwards, the Dictionary will be accompanied by a full set of National 
Curriculum based teachers’ notes. The CD-ROM can be used with any 
Archimedes system with 2 Mb of RAM and a compatible CD-ROM player and 
interface. It should be available from April onwards from Optech Ltd., East 
Street, Farnham, Surrey GU9 7XX, tel. (0525) 714340, fax (0252) 711121. 


COMPUTER CONCEPTS UPDATE 


The long awaited Faxpack from Computer Concepts is now available price 
£363,07 inc. VAT and carriage. This interface and supporting software turns an 
Archimedes into a full-feature fax machine. Operation can take place in the 
background, storing incoming faxes on disc for future viewing or high quality 
printing. 


The latest news on CC’s high powered graphic design package ArtWorks is that a 
release date is expected for some time in May. The package is expected to cost 
around £150 and will provide professional quality text and shape manipulation 
in full colour to rival the best currently available on PCs or the Apple Macintosh. 


We expect to cover both items in more detail in the next issue of RISC User, but 
in the meantime further information can be obtained from Computer Concepts, 
Gaddesden Place, Hemel Hempstead, Herts HP2 6EX. 


SPLITTING IMAGE 


Sherston Software has released a new clipart 
collection called Split an Image comprising around 
100 Draw files of the best known faces from 
politics, sport, royalty etc, together with a 
selection of bodies to which they can be fitted. 
All the images are based on original and 
specially drawn cartoons. Accompanied by a 
user's guide and activity cards, Split an Image 
costs £23.44 inc VAT from Sherston Software, 
Swan Barton, Sherston, Malmesbury, Wilts SN16 
OLH, tel. (0666) 840433, fax (0666) $40048. 


4MATION NEWS 


4mation is another software house to unveil some of its plans for 1992. Vector is 
billed as “the drawing package for the enthusiast”, and is written by Jonathan 
Marten, author of the highly regarded public domain program DrawPlus. 
Vector contains many new features for replicating and distorting objects 
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well as increased functionality. 
However, prices on these remain the 
same. 


Two pow, procecs have also been 
com , both designed as add- 
ons for the Forms Sulte. The Address 
Book and Calendar Creator enable 
the design and production of 
calendars, diaries and address books 
in A4 and personal organiser size, at 
£12.00 each or £20.00 if bought 
together, 


For more information contact 
MEWsoft at 11 Cressy Road, 
Ham; London NW3 2NB, tel. 


071-267 2642. 


SCANNED FROM AFAR 


As an alternative to more 
conventional 


scanners, lota 
produces the Image Scanner, 
available in black & white, and in 


scanned is placed, Two special 
lights provide even illumination 
across the scanner bed while 
scanning takes place. Image 
range costs from £399 ex. VAT from 
lota Software Ltd., The St John’s 
Innovation Centre, Cowley Road, 
Cambridge CB4 4WS, tel. (0223) 
421542, fax (0223) 421543. 


ALL FORMAT FAIRS 


Latest dates and venues for All 
Formats Computer Fairs are as 
follows: 


(ic 


z1 


Ws Softw 


> 


Desktop Thesaurus contains over 11,000 keywords and nearly 
90,000 carefully chosen alternative words. It is ideal for developing 
language skills in the office, in school or at home. 

The synonyms for the required keyword are listed in a scrolling 
window according to parts of speech, so nouns, verbs etc are grouped 
together. Clicking on any synonym itself then selects that word as a 
keyword and displays its synonyms, allowing you to browse through the 
data for the ideal alternative word. You can step back through earlier 
keywords, or step through the keywords in alphabetical order. When 
you have located an alternative word, it may be transferred instantly into 
almost any compatible application for you. Ideal for use with Ovation, 
Impression, Edit, Pipedream, 1st Word Plus, Pendown, Desktop Folio 
and other desktop publishers and word processors, 

Desktop Thesaurus uses a compression system allowing the 
Thesaurus data to use disc space efficiently. Thesaurus data is accessed 
directly from disc saving valuable RAM, but is almost instantaneous from 
hard disc (a little slower from floppy disc). 

Thesaurus data may be exported as plain text for editing, and the 
modified file re-imported into the Thesaurus. This powerful feature 
allows the Thesaurus to be easily modified or expanded. Due to the large 
size of the uncompressed data file, it is not possible to use this feature on 
a 1Mb RAM machine. 


Members Price £17.10 + VAT Site Licence Price £95 + VAT 


Ovation sets new standards of quality and value by offering professional 
features in an easy-to-use package al a very competitive price. We 
guarantee that you will be able to produce high quality documents 
within hours of opening the package. Ovation provides a formidable 
array of desktop publishing features, yet can be used just like a 
traditional word processor to produce single page letters or entire books 
with complete ease. The package includes a 250 page user guide suitable 
for both novices and experienced users, a quick reference card, 7 outline 
fonts, and a range of clipart. 


© multitasking/multi-documenis ¢ full WYSIWYG display 

* fast spelling checker (needs 2Mb) © variable views « headers/footers 
font size 1-1000pt * master pages * import draw & sprite files 

* full colour support © linked frames * multiple columns © stylesheets 
* definable frame borders « auto hyphenation (needs 2Mb) 

* find & replace ® line drawing © cut, copy, paste via clipboard 

© dot-matrix & laser printer drivers 


Members Price £86.09 + VAT 


C Development System 


The C Development System is a complete C language conforming to 
almost all of the ANSI specification, The package contains a compiler 
which is quick, easy-to-use and generates ARM code which may be 
linked to other programs using the linker. 

Also included is a multi-tasking editor from which programs may 
be written, compiled and executed without leaving the desktop. In fact 
you can compile, link and run C programs at the press of a key. The 
compiler errors are automatically highlighted in the editor for easy 
correction making it ideal for beginners learning C. 

‘The package also includes a range of RISC OS functions, a library 
manager for creating new libraries, a Make utility, and a built-in ARM 
assembler for advanced users. 


Members Price £68,70 


Site Licence $475 + VAT 


Site Licence £385 + VAT 
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including masking, radiating (like petals), path merging, interpolation, rotation 
and much more. 


Masque is described as a sprite animation package, for building up animated 
sequences. Scaling allows sprites to grow or shrink, providing an illusion of 
three-dimensional movement. Sequences can also be accompanied by text using 
outline fonts, and music in the form of Sound Tracker files can also be included. 


More supporting packs for use with 4mation’s smArt (see review in RISC User 
Volume 5 Issue 3) are planned including DoLittle (animal faces), Unwanted (for 
creating ‘wanted’ 
posters), Talk (for 
talking heads), and 
Sentiment (a file of 
scenes and expres- 
sions so that you 
can change the 
faces of people in 
these scenes). A 
number of smArt 
packs are also 
planned with particular emphasis on French and German, but also covering 
Dutch, Portuguese, Spanish, Turkish, Italian, Greek and Hebrew. 


4mation is at 14 Castle Park Road, Barnstable, Devon EX32 SPA, tel. (0271) 25353, 
fax (0271) 22974. 


GETTING HYPERACTIVE 


HyperActive DMA is a 
Digital Multimedia Adaptor 
card for the Archimedes 
range. It combines an 
exciting array of digital 
video processing capabili- 
ties to turn the Arc into a 
high performance multi- 
media platform. Hyper 
Active DMA provides three 
separately selectable (by 
software) video inputs, with 
two serial ports and a range 
of TTL inputs and outputs with driver software to control the majority of current 
videodisc and videotape players. Live video can be scaled, panned and zoomed to fit 
in a Desktop window, or can be displayed full size. 


In conjunction with HyperActive, British Nuclear Fuels has produced a set of 
three video discs on Energy, Radiation and Probability and Statistics, all written by 
teachers for 12 to 16 year olds, and designed to meet attainment targets of the 
National Curriculum. A complete system including an A3000, Phillips 
Laservision player, interfaces, discs and support materials costs approximately 
£1900. For information on HyperActive DMA, contact Allied Interactive Ltd., 
Unit 23, Team Valley Business Centre, Earlsway, Team Valley Trading Estate, 
Gateshead, Tyne & Wear NEI] ORQ, tel. 091-482 2214, fax 091-482 2214. For 
details of all the BNFL sponsored discs contact Interactive Learning 


Apr 26 National Motorcycle 
Museum, 


NEC, 
M42) 
May 16 Birmingham (J6, 
Centre, Esher (M25) 
Note the of venue for London 


fairs. Sandown will become the 
regular location for future London 
events. For Information and tickets 
contact John Riding on (0225) 868100. 


NEWS FROM SIMTRON 


Simtron, publishers of Archway, 
have recently sent a letter to all their 
customers still awaiting free 
applications promised in a 
promotion last summer. Simtron 
States that the advent of RISC OS 3 
has forced them to postpone 
completion of these applications, 
and that they have been working on 
a new version of Archway itself 
which will be fully compatible with 
RISC OS 2 and RISC OS 3. The 
promised applications will be 
por “yaa during this year, and they 

the run-time 
Soaele from this new version of 
Loot rare are at 4 Clarence 

Grinstead, West Sussex 


RHI19 4RZ, tel, (0342) 328188. 
TRAILSOFT 
TraliSoft, whose spreadsheet 


UP PERISCOPE 

Periscope Software, publishers of 
Karma - The Trainer (reviewed 
last month In RISC User), has set up 
two new telephone hotlines. For 
Sales and Enquiries try (0272) 
767854, and for the Technical 
Hotline phone (0839) 668811. 
Periscope Is at 302 Wedon Way, 
Bygrave, Baldock, Herts SG7 5DX. 


COMMUNICATING WITH 
PSION 


If you have a Psion series 2 then !CL 
may be of interest. This is a 


multitasking communication program 
pny Aemsberdh mieay ICL costs 


Productions Ltd., 3rd Floor, North Street Court, North Street East, Newcastle- 43 Prestbury petig— Sahpate Vilage, 
upon-Tyne NEI 8HD. Worcester WR4 9XG. 
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Aleph One's 386 
PC Expansion Card 


Mike Williams previews the first hardware PC card for the Archimedes. 


BY the time you read this, Aleph One 
should be shipping their first batch of 
386 PC Expansion Cards. At the time of 
writing Aleph were unwilling to release a 
386 PC Card for a full review as the 
supporting software was still under 
development. However, this new card has 
such obvious potential that we couldn’t 
wait, and this overview is based on a visit to 
Aleph One to see the new card in action, 
and to find out more about it. A full hands- 
on review will appear in the near future. 


The 386 PC Card is a single-width card 
which can be fitted to all models in the 
Archimedes range, though the A3000 will 
require an external expansion box to 
accommodate it. The board contains an Intel 
80386SX-compatible processor running at 20 
MHz and a single-chip PC motherboard, 
manufactured under licence by VLSI. The 
board will be supplied fitted with either 1 Mb 
or 4 Mb of RAM, and there is a socket for an 
optional 803875SX floating-point processor. 


The board also sports a fully bi- 
directional parallel port for direct printer 
connections (and also for devices such as 
scanners, which use the parallel port in the 
PC world), and a fully PC-standard 9-pin 
serial port. 


By agreement with Acorn, the board 
relies on the user having obtained version 
1.6 or later of the PC Emulator (and either 
MS-DOS or DR DOS). Aleph One also 
supplies its own supporting software on 
disc which is integrated with Acorn’s PC 
Emulator to provide a look-alike front end 
to the 386 PC Card. Double-clicking on this 
installs it on the icon bar, and clicking Select 
switches to PC Emulation using full screen 
mode, or RISC OS multi-tasking mode 
(though only the former was operational in 
the pre-release version of the software seen). 


When the switch to PC Emulation is first 
made, the application downloads the MS- 
DOS kernel, BIOS, from disc followed by 


MS-DOS (or DR DOS) itself. Once loaded, it 
is possible to change almost instantaneously 
from RISC OS Desktop to single screen PC, 
and back. 


Peta 
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Aleph One's 386 PC Card 


Apart from the processor, motherboard 
and serial/parallel ports on the 386 PC 
Card, a full PC clearly needs keyboard, 
display and filing system support. Under 
Aleph One’s implementation, these features 
are supported as normal by RISC OS, with 
software providing the interface between 
the Arc and the PC, and this also includes 
the mouse, standard on an Arc. This can 
actually lead to enhanced performance 
compared with a genuine PC, as the Arc’s 
own powerful ARM processor can 
effectively handle these devices in parallel 
to the 386, and reduce the loading on the 386 
processor. It also means that the ARM 
processor can cache disc access using ARM 
memory, for example, providing as much as 
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tenfold improvements in data transfer rates 
to and from disc. 


This approach also has implications as 
far as display modes are concerned. The 386 
PC Card will support up to VGA resolution, 
but what can be achieved is dependent 
upon your choice of Arc monitor and its 
own display modes. The 386 PC Card 
cannot achieve VGA standard unless your 
monitor and Arc are already capable of this. 
It also means that when multi-tasking in a 
window, one higher level of resolution is 
required overall to the standard to be 
achieved within a window. 


All of this may sound quite technical, 
but in practice means that the 386 PC Card 
using the Arc as a high powered I/O 
processor can achieve both a very high level 
of PC compatibility, and fast operation in PC 
mode, For example Aleph One claims that 
the 386 PC Card on an A5000 achieves two 
to three times the performance which can be 
obtained with the software-only PC 
Emulator from Acorn. There is also good 
news concerning prices. Since our first 
report in RISC User Volume 5 Issue 4, Aleph 
has reduced the price of both versions of the 
386 PC Card by £100. 


FUTURE ENHANCEMENTS 

There are expected to be a number of 
software enhancements to the 386 PC Card. 
The first, expected in about three months, 
will be a Microsoft Windows driver which 
will use the Arc’s power to produce 
enhanced graphics display emulation for a 
much smoother and faster refresh of the 
screen under Microsoft Windows. 


Intelligent dise caching will dynamically 
increase and decrease the size of the disc 
cache according to demand from the PC 
and/or Arc. It will also be possible to 
allocate Arc memory as a RAM disc for the 
PC, or allocate PC memory as a RAM disc 
for the Arc. 


Users can also expect improved printer 
support. With its own parallel port on 
board, alternately printing from a PC 
application, and from an Arc application 
will require the user to connect his printer 
first to the PC port, then to the corresponding 
Arc port (or use a splitter). Future software 
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support will allow the PC to print via the 
Arc’s printer port using standard RISC OS 
printer drivers. Discussion is also taking 
place with Computer Concepts with a view 
to using the latter’s Laser Direct as a printer 
for the 386 PC. 


Furthermore, Aleph will be providing 
Novell network support, a low cost ethernet 
system. And finally, in a move which will 
surely find favour with some educational 
users, the 386 PC Card will also be able to 
run non-PC compatible RML Nimbus 
software, in a move which will no doubt 
find favour with Acorn in their on-going 
battle with RML for the educational market. 


Some of the software developments 
listed above may be bundled in with the 386 
PC Card, but the more significant ones will 
probably carry a small charge to cover 
development costs. 


IN CONCLUSION 

Aleph One’s 386 PC Expansion Card will 
surely excite much interest from the many 
Archimedes owners who currently use 
Acorn’s PC Emulator, and indeed may well 
enhance the attractions of the Arc to those 
more firmly wedded to the PC world. It 
would certainly appear on first impressions 
that the combination of 386 PC Card on an 
Arc provides both a highly compatible and 
fast PC environment, albeit at a price. 


As such this would seem to restrict its 
usage to the more serious user of PC 
applications. There is perhaps also a danger 
in that the facility to run PC applications 
really effectively might itself stifle the 
development of equivalent RISC OS Desktop 
erage Personally, I do not believe this 
is likely to be the case, but the advent of 
Aleph’s 386 PC Card, good as it seems, does 
open up the possible charge that the 
Archimedes (with PC card) is no more than 
yet another PC clone. I certainly hope not. 


386 PC Expansion Card 
Aleph One Ltd. 
The Old Courthouse, 
Bottisham, 

CBS OBA. 


Cambridge 
Tel. (0223) 811679 
Fax (0223) 812713 
Price £495 ex. VAT (1 Mb) 
£625 ex. VAT (4 Mb) AU 


Product 
Supplier 
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by Gordon Gilmore 


n earlier issues of RISC User (Volume 3 

Issues 5 and 6) Mike Summerton 
provided two articles explaining how to use 
the Draw module from within Basic to plot 
Draw files. This two-part article considers 
the inverse problem - the use of Basic to 
create Draw files. The program presented 
here consists of a short test program 
followed by a library (CDraw) of easy to use 
procedures which allow simple figures and 
text to be created. Because of its length, the 
program presented this month will deal 
only with text and font objects, and 
the routines to be added next month 
will deal with line drawings. As a 
result the line numbering is 
not regular to allow lines to 
be inserted next month, so do 
take care when entering the 
program. 


The structure of a Draw file was 
explained in Mike Summerton’s first article 
and is summarised in Table 1. I shan’t be 
describing the structure of Draw files in 
detail, but for those interested in the ‘nitty 
gritty’, the Draw module is described in 
pages 1487 to 1512 of volume IV of the 
Programmer's Reference Manual, and the 
important ones from our point of view are 
1492 to 1497 where the Draw file data 
structures are presented. 


A Draw file consists of a collection of 
objects preceded by a header which contains 
only a file type identifier, the name of the 
program which created it and the overall 
bounding co-ordinates. These are the co- 
ordinates of the box (in internal Draw co- 
ordinates) which will just enclose the whole 
of the drawn figure. Each object description 
consists of a type identifier, the size in bytes 
of the description, the overall object co- 
ordinates and then all the data needed to 
describe the object. One of these pieces of 
information is a flag which tells the Draw 


Paladin 


module how to join and cap lines and create 
other subtle effects. In the complete 
program given here this flag is fixed but 
could easily be altered to suit. Once you 
realise how simple it is to create these Draw 
files, then altering CDraw to allow these 
extra features should be no problem. 


eres 


Output of listing 


CDraw only considers three types of 
object - line drawings (next month), font and 
text objects. The Draw module plots figures 
using internal Draw units, which are not the 
same as Archimedes operating system units 
used for plotting to the screen. For ease of 
understanding, the procedures are written 
in such a way that all co-ordinates are in OS 
units which one would normally specify 
when using the MOVE, DRAW, LINE, and 
CIRCLE commands in a Basic program. 


The latter part of the program is 
intended to be used as a library of 
procedures, and can be accessed by a 

LIBRARY *CDraw* 
command from within a program. To 
minimise possible interference with the 
calling program, all global variables which 
are defined and used by the CDraw 
procedures are preceded by an underscore, 
and all global variables which should be 
accessed by the calling program are preceded 
by CDraw_. The easiest way to explain the 
procedures is to use them, so here we go. 
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USING THE PROCEDURES 

We must start by calling the procedure 
PROCCDraw _initialise to initialise the 
system. If we do not call this procedure, the 
other procedures will generate an 
‘Unknown or missing variable’ error. 


name$ is any name you care to label the 
resulting Draw file with - the name used in 
the test program is “CDraw_Test”. 


nfonts% is the number of fonts you 
intend to use. 


size% is the size of the buffer in which 
the Draw file will be created and saved 
from. No doubt it would be possible to 
calculate a figure for size% but it is much 
easier to make a guess and increase it if 
things don’t work out. 


Initialisation creates the buffer in which 
the Draw file is actually created and saved 
from, DIMs an array to hold the font list, 
sets various internal variables and finally 
sets two global variables: CDraw% and 
CDraw_nofill%. 


CDraw% is a flag to indicate to the other 
procedures that initialisation has been 
performed. CDraw_nofill% is a variable used 
to specify that a path should be unfilled (see 
next month). 


If you intend to create a text object and 
you are going to use a font other than the 
system font, you must create a font list in 
the array CDraw_Font$() (which is 
dimensioned by the initialisation). For 
example: 


CBraw_font$(1)="Paladin.§ 


CDraw_fonts (2)=*Trini 


Repeat this with a different index for 
each font you wish to use. Leave 
CDraw_font$(0) empty since font 0 is 
defined as the system font. Having filled 
the font list array, you should call 
PROCCDraw_fontobject to create the 
appropriate font object in the \buffer 
(basically this tells Draw which fonts it can 
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use - it should be looked on as a fonts 
initialisation). If you only intend to use the 
system font then you need not bother 
creating a font object. In the example 
program the fonts Paladin and SwissB are 
used: if you don’t have these fonts then 
change lines 130-150 to fonts you do have. 


Having created the font object you can 
now create text objects. Even though the 
procedure call is long, it is a very simple 
process. The call to create a text object is: 

PROCCDraw_textobject {font$, rext$, 
ptsizet, pthigh$, xorigin’ ,yorigint, fg9%, bot) 


font% is the number of the font to use 
with 0 indicating the system font. 


text$ is the text you wish to create. 


ptsize% is the point size of the text. If you 
are using system text the normal point size 
you will see plotted on the screen is 6.4 


pthigh% is the height of the text in 
points. Normal screen system text is 12.8 
points high. 


xorigin% and yorigin% are the screen co- 
ordinates of the bottom left of the text area. 


fg% and bg% are the foreground and 
background colours. 


Calling this procedure with the relevent 
parameters will create the text object, and 
that’s all there is to it. Next month we take a 
look at the more complicated affair of line 
drawing. 


( »CDraw_Test 

f Program CDraw Test Program 
Version A 2.0 
Author &.R.Gilmore 


( RISC User April 1992 
Subdjec=s to Copyright 
Not Public Domain 


90 REM Set up space for data 
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3,&2000) 

110; 

120 REM Set up font object 

130 CDraw_font$(1)="Paladin.Roman* 

140 CDraw_font$(2)="Paladin.Roman.ital 
ic* 

150 CDraw_font$ (3)="SwissB.Bold* 

160 PROCCDraw_fontobject 

170 : 

180 REM Underlined text in System Font 

190 PROCCDraw_textobject(0,"System Fon 
t*,6.4,12.8,100,100,7,0) 

210 : 

220 REM Paladin text inside dotted box 

230 PROCCDraw_textobject(1,"Paladin®, 
18,24,200,200,10,7) 

280: 

290 REM Italic Paladin text object 

300 PROCCDraw_textobject(2,*Italic Pal 
adin*®,18,24,300,300,7,9) 

310: 

320 REM Bold SwissB text inside red bo 
x 

370 PROCCDraw_textobject (3, "Bold Swiss 
B*, 36,24,400,400,0,7) 

380 : 

390 REM Paladin text inside grey circl 
e 

410 PROCCDraw_textobject(3,*Circle*, 1 
2,24,550,190,0,7) 

420 : 

430 REM save draw file to disc 

440 PROCCDraw_savefile(*Test*) 

450 : 

460 REM Reset buffer pointer ready for 
creation of next file 

470 PROCCDraw_reset 

480 END 

490: 

500 : 

510 REM >CDraw 

520 REM Library Routines for creating 

530 REM simple DrawFile text and path 

540 REM objects and saving 4 draw file 

550 REM to disc 

560 REM All private global variables 

570 REM have names beginning with _.. 
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580 REM All user global variables have 

590 REM names beginning with CDraw_.. 

600 : 

610 DEFPROCCDraw_initialise(app1_name$ 
, nfonts$, size) 

620 DIM _buffer% sizet 

630 _ptr%=_buffers 

640 S_ptrt=LEFTS ( *Draw*+CHR$201-STRING 
$(12,CHRS(0)),12) 

650 _ptrt+=12 

660 S_ptr®=LEFTS (appl_name$+STRINGS (12 
a? “hi, 32) 

670 DIM CDraw_fonts (nfonts%+1), _colou 
rsé 20*4, _dash$(4) 

680 SYS*Wimp_ReadPalette",, _colours% 

690 _dasn$(1)=STRINGS$ (6, CHRS0+CHRS9-+CH 
RS0+CHRSO) 

700 _dash$ (2) =STRINGS (6,CHRSO+CHRS18+C 
HRSO+CHRSO) 

710 _dash$ (3) =STRINGS (6, CHRSO+CHRS36+C 
HRS0+CHRSO) 

720 _dash$ (4) =CHRS0+CHR$36+CERS$0+CHRSO 
+STRINGS (3, CHRS0+CHRS9+CHRS0-+CHRSC) 

730 _flags$=&20100042 

740 PROCCDraw_reset 

780 _flagst=4£20100042 

760 COraw_nofill%=-i 

770 COrawt=TRUE 

780 ENDPROC 

790: 
800 DEFPROCCDraw_reset 
810 _otrt=_buffer$-40 
826 _olxt=1<<30:_obyt=i<<30 
830 _orxt=0:_oty$=0 
€40 ENDPROC 
850 : 
860 DEFPROCCDraw_savefile(f$) 

870 If CDraw’ THEN 

880 _buffer%!24= _olx3 

890 _buffert!28=_oby$ 

990 _buffer$!32=_orx$ 

910 _buffer$!36=_oty$% 

920 SYS "OS _File",10,£S,&AFF,, buffer 
%,_ptrs 

930 ENDIF 

940 ENDPROC 

950 : 
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960 DEFPROCCDraw_fontobject 
970 IF CDraw_font$(1)<>** AND CDrawt 7 
HEN 
$980 LOCAL _start%,I% 
990 _start$=_ptrt 
1000 PROC_putword (9) 
1010 _ptrt+=4 
1026 I$=1 
1030 WHILE CDraw_font$(I%)<>*" 
1040 ?_ptr&=-It 
1050 $(_otr&+1)=CDraw_font$ (I$) 
1060 _ptr$+=LENCDraw_font$ (1€) +2 
1070 ?{_otr’-i2)=0 
1080 I%+=1 
1099 ENDWHILE 
1100 WHILE _ptr$MOD4<>0 
1110 7_ptrt=0 
1120 _ptrt+=1 
1130 ENDWHILE 
1140 _start$!4=_ptrt-_startt 
1150 ENDIF 
2160 ENDPROC 


1180 DEFPROCCDraw_textobject (font, text 
$,ptsize,pthigh, xorigin$, yorigint, f9%,b¢ 
$) 

1190 IF CDrawt THEN 

1200 LOCAL start?,1x%,by$,rx$,tyt 

1210 _startt=_ptré 

1229 PROC_putword(1) 

1230 _ptr%+=20 

1240 lx=xor:gin$ 

1250 byt=yorigint-4-6* (font’<>0) 

1260 rxt=xorigint+ptsize*2.5*LENtexts * 
(1+0.6* (font t<>0))} 

1270 ty%=yorigin’+pthigh*2.5+4 

1280 PROC_putcoords{_startt-8, xt, by%,r 
x8, ty®) 

1290 PROC_putword (FN_colour (fg%)) 

1300 PROC_putword (FN_colour (bg) ) 

1310 PROC_putword(font$) 

1320 PROC_putword (ptsize*640) 

1330 PROC_putword (pthigh*640) 

1340 PROC_putword(xorigin’<<8) 

1350 PROC_putword (yorigin<<8) 

1360 PROC_putstring (texts) 

1370 _start$!4=_ptr$-_starc$ 

1380 PROC_checkspace(1x$, by, rx%, ty?) 
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1390 ENDIF 

1400 ENDPROC 

1410: 

1420 DEFFN_colour(c%) 

1430 IF c¥>=0 THEN =! (_colours$+c#*4) A 
ND GFFFFFFOQ ELSE =-1 

1440 : 

1450 DEFPROC_checkspace (1x%, by$, rx%, ty 
) 

1460 IF ixt<_olxt THEN _olxt=1x% 

1470 IF byt<_oby® THEN _obyt=by$ 

14B0 IF rx%>_orx® THEN _orx$=rxt 

1490 IF tyt>_oty® THEN _otyte=ty% 

1500 ENDPRCOC 

1510 : 

1520 DEFPROC_putword (Ws) 

1530 !_ptrt=wt 

1540 _ptrt+=4 

1550 ENDPROC 

1560 : 

1576 DEFPROC_putstring(S$) 

1580 $_otrt=S$ 

1580 _ptr$+=LENSS 

1600 REPEAT?_ptr%=0 

1610 _ptré+=1 

1620 UNTIL _ptr’MoD4=0 

2630 ENDPROC 

1640 : 

1650 DEFPROC_putwords (xt, Y$) 

1660 Xt=K¥<<8: YE=VEKB 

1670 IF X&<_start®!& THEN _start$!& =X 
% 

1680 IF Y$<_start%!l2 THEN _start$!12=¥ 


1690 IF Xt>_start#!16 THEN _startt!i6= 
1700 IF Y&>_starc!20 THEN _start$!20=¥ 


1710 PROC_putword (X%) : PROC_putword(Y%) 
1720 ENDPROC 

1730 : 

1740 DEFPROC_putcoords(_start?, 1x%, by 
&, rxt, ty’) 

1750 _start$!0=lxt<<# 

1760 _start$!4=by$<<8 

1770 _starct!8=rxt<<8 

1780 _start$!12=ty%<<8 

1790 ENDPROC AU 
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ACORN ARCHIMEDES COMPUTERS 
EXPANSION OPTIONS 
FOR 
INDUSTRIAL & SCIENTIFIC 
APPLICATIONS 


HARDWARE - IEEE488 Interface, 16 Bit Parallel 
1/O, Dual RS423 Serial Interface, 12 Bit ADC, 

STE Bus Interface and complete range of STE Bus 
Boards, SCSI Devices-Hard discs, Magneto-Optical 
Drives, Tape Streamers, Gigabyte Tape Drives, 
Removable Hard Discs Plus all Acorn Products 


SOFTWARE - GINO - F 3D, GINOGRAF, GINO- 
SURF, HERSHEY+, VIEWGRAF, VIEWSURF, 
Termulator etc 


ADVICE - SUPPLY - SUPPORT 
CONTACT 


INTELLIGENT INTERFACES LTD 
TEL 0703 261514 FAX 0703 267904 


PO Box 80, Eastleigh, Hants, SOS SYX 


Squirrel 


Reviewed by John Schild 


OVERVIEW 

Squirrel is a database management 
system with relational capabilities (that is, it 
can link records in files containing common 
fields). It is fully RISC OS compliant, runs in 
all screen modes and multi-tasks with other 
applications on the Desktop. It is written in 
C, and the Task Manager shows it as two 
applications - the front end and the engine - 
occupying a total of 550 kilobytes of RAM. 
Thus it will work alone on a one megabyte 
system, but for effective multi-tasking with 
a document processor, it needs twice that 
capacity. It will run from either floppy or 
hard discs on all Archimedes and ‘A’ series 
machines, including the A5000. It is driven 
from a comprehensive menu structure with 
a few quickly learned key short cuts. Data 
storage capacities are not software limited, 
but extend to the limits of the host machine 
or network. Single and multi-user versions 
are on offer from the producers, Digital 
Services Ltd. 


SQUIRREL - WHAT'S IN A NAME? 

Squirrel has been quite heavily 
promoted through full-page advertisements 
in the glossy magazines, and having for 
several months been intrigued by those little 
fellows scampering amiably across the 
inside cover of Acorn User, I have been 
looking forward to an opportunity to see for 
myself whether Squirrel really is the best 
thing since sliced hazel nuts. My verdict is 
easily stated: given a few necessary 
enhancements Squirrel is on course to 
become the definitive DBMS for the Acorn 
range of computers. 


In this connection I find it significant 
that the endearing creature which sits 
patiently on the icon bar is coloured red 
rather than grey, indicating a native species 
of software, designed around RISC OS, 
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rather than a product of grey anonymity 
ported uncomfortably across from another 
domain. In fact the name Squirrel was 
chosen not as an indication of how it hides 
and retrieves its data but as a playful 
allusion to the initials SQL, which (the 
manual surprisingly fails to explain) is the 
standard abbreviation for Structured Query 
Language - a feature at the heart of many 
relational database systems. 


PRESENTATION AND INSTALLATION 

Squirrel is delivered in the now almost 
mandatory ring binder in smart box format. 
The 200 page manual is well written and 
amply illustrated. The tutorial section is 
realistically brief, and the reference section 
falls short in only a few areas. 


Installation is rather novel. Placing the 
write-protected master disc in the floppy 
drive and clicking on it brings up a message 
inviting the substitution of a blank disc. This 
is then formatted and the application copied 
across. 


A window opens requesting that the 
purchaser type in some personal recognition 
details (company name or what-have-you) 
which the software then encrypts with a 
letter/number sequence displayed in 
another box. At this point, you turn from the 
computer to the telephone; ring Digital 
Services, tell them what is displayed in the 
two windows, and they do some magic 
which generates a key number. This in turn 
unlocks the software for use. Type this 
number into a third box and hey presto, 
your Squirrel comes out of hibernation! The 
application can then be copied to a hard disc 
or used from the working floppy. 


Presumably this rather tortuous 
procedure is the producer's device to make 
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sure every copy which goes out is registered 
and traceable, and since the software is not 
otherwise protected, who can blame them? 


SQUIRREL IN USE - A GUIDED TOUR 

Squirrel operates from six different 
screens: Create, Data, Query Define, Query 
Data, View, and Report. Separate 
applications handle file import and mail- 
merge. 


CREATE MODE 


Once Squirrel has been loaded 
onto the icon bar, clicking Menu 
here reveals the Create option, 
which, in turn, leads to the Create 
window. This is where Squirrel 
begins to score high marks. 
Creating a new table (in card index 
form) is simplicity itself. It is highly 
intuitive and very quickly learnt. 
Pointer dragging creates boxes 
which are readily re-sized and re- 
positioned. A neatly nested set of 
menus presents a wide range of 
options for each field. Field types are 
offered in embarrassing profusion, with up 
to ten pre-defined. 


The obvious choices are all available: 
fixed and variable length alphanumeric; 
fixed and floating point numeric; date, in as 
wide a variety of formats as the mind of 
man could conceive; boolean (yes or no 
only), as well as textfiles - displayed in a 
scrollable window - and Draw files and 
sprites, scaled to fit a user-defined display 
box. These last two will prove invaluable for 
folk like me who are forever creating sprites 
and Draw files for document processing and 
then totally losing track of where they are 
stored. 


A feature I know I am going to love is 
Squirrelés ability to teach the system where 
to find a table storing a particular file type - 
sprites for example - so that when a sprite 
icon is dragged to the Squirrel icon on the 
icon bar, a dialogue box opens allowing the 


insertion of a file name, and then storing the 
sprite in the appropriate table until called 
for using Squirrels search facility. Brilliant, 
but financially hazardous because it has 
forced me to reconsider what size hard disc 
I shall need when I upgrade my machine. 
Incidentally, I couldn't persuade this facility 
to operate through Computer Concepts 
Compression. 


oly Fixed 
Floating 


Outline fonts may be used for both 
headings and data, in any point size and 
with colour options for text and 
background. A nice feature is a validation 
facility to make sure that data entry to any 
selected field conforms to a validation list, 
or lies within a chosen range of values. 
Fields may be set to accept any file type or 
made specific to a particular file type, Basic 
programs or Pipedream files for example, 
but sadly not Impression files because these 
are seen by the operating system as 
applications. 


THE DATA SCREEN 


Once a table has been designed it may 
be saved and immediately becomes 
operative. Data can be entered from the 
keyboard or dragged from a text editor or 
filer window. Because data storage is 
dynamic, fields may be added or edited 
after data entry has commenced. All 
alphanumeric, numeric and date fields are 
indexed, and by placing the caret in any 
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field, you can browse through the database 
in the ASCII order of the selected field. 
Within the Data screen, records may be 
added, edited or deleted, and the record 
being viewed may be printed. Fields can be 
dragged to filers, editors or other 
applications. Menu options lead back to 
create mode for further table editing, or on 
to the Query Screen. 


QUERY AND QUERY DATA SCREENS 


Queries may be simple 
or complex. Selecting the 
Query screen displays a 
blanked out replica of the 
Data screen. A string, 
including the wild card 
character (*) if required, 
may be typed into any 
field and a_ search 
executed. A box displays 
the number of matches 
found, and the Query data 
is displayed in a Query 
Data screen. A sort may 
be imposed by dragging 
fields to a Sort Order box 
and ranking them as 
desired. Squirrel allows 
alphanumeric fields to be 
sorted in dictionary order 
as an alternative to ASCII 
order, so numbers will 
still be in the right order 
without leading zeros (i.e. 9 before 10), 
and the upper and lower case characters 
will not be separated. Provision is made to 
save a Query for future use, and a Query 
Data subset of a file may be re-designated 
as a new table and saved alongside the old 
one. 


Perhaps the most innovative and 
attractive feature of Squirrel is the graphical 
display of the Structured Query Language 
employed in making complex searches. 
Type *Smith* into the Name field of a table, 
and Portsmouth into the town field, and 
then open the Show Filter window. This 
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displays two linked boxes, the first 
containing the legend [name LIKE 
%Smith%] and the second [town = 
Portsmouth] indicating an AND search. 
Dragging fields from the Query window 
into the Query Filter window allows serial 
(AND) and parallel boxes (OR) to be linked 
together and their contents edited to 
produce complex search criteria. 


THE VIEW SCREEN 


A View can be created by 
selecting an option from 
the icon bar menu, which 
opens a blank window. 
Any fields can be dragged 
to this window from the 
data window of any tables 
open on the screen, and 
this is the essential 
starting point for 
relational queries - queries 
linking together two or 
more tables which have a 
field in common. Fields 
containing cal-culations 
can be included only in 
Views. They are set up 
from the field details box 
employing a calculate 
option combining the basic 
arithmetical operators in a 
straightforward syntax. 
Results of calculations can 
be included in reports. Naturally, Views can 
be saved for future use. 


Relational queries are set up by 
designating one table as the primary ‘A’ 
table, and others as B, C, ete. (as far as Z). To 
bring two tables together in a relational 
query, a field is dragged to the Query Filter 
window from the A table, and the resulting 
legend edited to read [A.<fieldname> = 
B.<fieldname>] where B is the second table 
and the field names are identical. From this 
point a relational query can be structured, 
data being drawn from both tables and 
presented in a report. The manual rather 
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Archimedes Software 
Banish Those Jaggy Blues ! 


Disc 35 Trace 

@ Trace converts Sprites into Draw files. 

@ Sprite format clip art is cheap and plentiful. Draw clip art is expensive 
and usually has to be painstakingly drawn by hand. 

@ Sprites take up lots of disc space. Draw files are smaller. 

@ Scaled sprites have jagged edges. Draw files scale perfectly. 

@ Unlike some programs, Trace will handle full colour sprites. Trace 
works automatically with no user help. 

@ You can now use the powerful tools in Draw for manipulating Sprites. 

Comes with D2Font program for making outline fonts from Draw files. So 

you can scan your own fonts. Examples of Trace and D2Font included. 


Disc 7 - Chess Program for The Archimedes. 

A Chess program that takes full advantage of RISC OS, installing itself on the icon 
bar and running on the desktop in a window. You can work with other programs 
whilst you play Chess. Many features, computer play, hint, save games, edit etc. 
Risc User July 1991 said: "Chess is an absolute bargain. .playing at a comparable 
level it always beat Micro Power's offering. ...this has to be the one to go for". 


Disc 8 - CrossStar 2.XX Crossword puzzle solver 

Fully RISC OS compliant desktop Crossword puzzle solver. 200,000 word 
dictionary. Solves interlocking clues. Editable/user definable dictionaries. Saves 
grids as Draw files. Browse through dictionary. Check grid for new words. 


Disc 32 - Charm. High level language and environment. 

Charm, is a high level language similar to Pascal and C. This implementation, 
includes a compiler, linker and assembler, with an editor, and a desktop 
environment to use them. The Charm system is both fast and ideally suited to 
being used on 1Mbyte and floppy machines. Demos with source, Chinese 
checkers and an arcade style game. An easy way to produce ARM code programs. 


Disc 33 - Panorama. Your window on the World! 

180,000 coordinates outlining the lakes, rivers, continents, state boundaries etc. of 
the World and a program that can produce Draw files from them. You can make 
maps of any part of the world and then use them in DTP etc. programs. Includes 
the positions of nearly 1000 cities. Does simple, cylinder, Mercator and perspective 
projections. Can be used from a single floppy disc and requires no setting up. 


Disc 16 - Spark RISC OS Archive program 

Spark, allows you to store files and directories in archives in a compressed form. 
e.g. sprites often take up only 10% of normal space. Files in archives, can be 
accessed just like files on disc. Reads all these formats, zoo, zip, Izh, UNIX and 
Archie Tar, Compress. Reads and writes PKarc, SEA/PC arc, uucode, atob, fcet. 


Discs are £5.99 each, all inclusive. Buy four claim an extra one free! 


David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 
Free Air Mail delivery on overseas orders. Extensive range of other Archimedes software 
available (programmers tools, games, utilities, clip art), please send for free list. 


Squirrel 


falls down here by failing to explain how 
the table linking logic should be extended to 
include more than two tables. 


REPORTS 

This is the only area where I 
experienced any difficulty in 
understanding Squirrel. I did not find the 
report building procedure half so simple 
and intuitive as the manual led me to 
expect, and I had to spend many 
frustrating minutes with the computer 
under one hand and the book in the other 
before the penny dropped and I saw, at 
least vaguely, what the programmer meant 
by his claim that reports are generated in 
layers. The suppliers acknowledge the 
problem and have promised an upgrade 
(version 1.1) within a few months which 
offers three default report styles (including 
address labels not so far offered), and more 
help for those of us still in the infants class. 


Suffice it to say that once understood, 
Squirrel provides for quite a lot of flexibility 
in selecting and placing fields in reports, 
which may then be previewed, printed via 
the RISC OS printer drivers, or exported as 
CSV or text files to other applications. 


OTHER FACILITIES 

An import application is provided 
separately on disc which allows for the 
import of data from other databases. It 
defaults to CSV or TSV input, but any field 
and record delimiters can be substituted. 
The technique is quickly learnt, and I had 
no difficulty in transferring a substantial 
table from a PC database run under the 
emulator. 


From issue 2.1 onwards, Computer 
Concepts’ Impression is provided with 
hooks to pull in data from an external list 
for mail-merging, and to the best of my 
knowledge Squirrel 1.07 is the first DBMS to 
build in corresponding software to access 
this facility. Under test it performed easily 
and effortlessly. 
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CONCLUSIONS 

What Squirrel does, it does very well 
indeed. The ease of table creation, data 
entry and browsing, searching and sorting 
place this innovative software in the first 
league, and the diagrammatic 
implementation of the structured query 
language in simple and relational searches 
is unique and may well prove to be trend- 
setting. 


However, if Digital Services charming 
little rodent is to win an Oscar for the most 
outstanding performance on the small 
screen, some enhancements will be 
necessary. My list of desirable additions 
would include macros, global field entry 
and deletion, password protection of 
selected fields, and a more sophisticated 
approach to report generation, naturally 
including address labels, but also the 
ability to close up the gaps where several 
fields share a single line of a report. 
Soundex searches too would be desirable 
and I suspect some users will need a rather 
fuller set of expressions for field 
calculations. The manual would benefit 
from some improvements as indicated. 


Digital Services declare themselves to 
be committed to the continuous 
development of this important product. 
Because they have started in the right 
place and have designed imaginatively 
around RISC OS I think the Acorn world 
may have here the promise of its definitive 
database. For the moment no other 
product approaches the performance of 
Squirrel at anything like the price and it is 
to be highly recommended. 


Product 
Supplier 


Squirrel 

Digital Services Ltd. 
9 Wayte Street, 
Cosham, 
Portsmouth, 
Hants PO6 3BS. 
Tet. (0705) 210600 
Price £151.58 inc. VAT 
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Desktop Character Rulers — 


by Mark Moxon 


ere’s a question for you: what goes “...43 

44 45... darn, lost count! (sigh) 1 2 
and then paces round the room in 
frustration? Answer: someone trying to count 
the number of characters in a line of text. 


Solution: this rather handy ruler 
application. This allows movable horizontal 
and vertical rulers to be displayed on the 
Desktop, with graduations every system 
font character. Simply click Select on the 
icon bar icon and both rulers will pop up. 
They can be dragged around the screen, and 
clicking Adjust on a ruler will toggle its size 
between full screen width/height and two 
thirds of that size. Alternatively the rulers 
can be turned on and off independently 
through the icon bar menu. 


Text can be eeerirsd 
easily using this handy 
ruler ee boat 
‘This is the fourth line 


-and this arrow is in the 
‘A6th column: 


Rulers in action 


CREATING THE APPLICATION 

First of all create a directory called 
!Rulers, and open it up by double-clicking 
on it while holding down Shift. Next use 
Edit to create an Obey file called !Run 
containing the following three lines, and 
save it inside the Rulers eee: 


Next type in listing 1 and save it as 
RulerSpr. Running it creates a file called 
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Sprites in the current directory, which 
should also be put inside !Rulers. Next enter 
listing 2 and save it inside !Rulers under the 
name !RunImage. Finally there's the hard 
part (at least it is for people like me who 
can’t design sprites to save their lives); use 
Paint to design a sprite called !rulers (mode 
12, 34 pixels wide by 17 pixels high) and 
save this file as !Sprites in the !Rulers 
directory. 


That's all there is to it. Now running the 
application installs an icon on the icon bar, 
and you can measure characters all night 
long without so much as a whimper. 


Listing | 


REM >RulerSpr 


hrulerl*, *hruler* 

280 FOR it=2 TO 160 

290 CASE i$MODIC OF 

300 WHEN 1,2,3,4,6,7,8,9:r$="i" 

310 WHEN S:r$="2" 

320 WHEN O:r$="3" 

330 ENDCASE 

340 SYS *OS_SpriteOp", 256+27, sprite$," 
hruler*+r$, “hrulerT® 

350 SYS "OS_SpriteOp", 256+35, spritet,* 
hruler", "hrulerT",0 

360 NEXT if 

370 FOR it=1 TO 3 

380 SYS "OS_SpriteOp", 256+25, sprite$, * 
hruler*+STRS$ (i$) 

390 NEXT it 

400 : 

410 SYS "OS_Spritedp*,256+27, sprites," 
vrulerl", “vruler" 

420 FOR it=2 TO 80 

436 CASE i$MOD10 OF 

440 WHEN 1,2,3,4,6,7,6,9:r$="1" 

450 WHEN 5:rS=*2" 

460 WHEN O:r$="3* 

470 ENDCASE 

480 SYS “OS_SpriteOp",256+27, sprite$, * 
vruler"+r$, “vrulerT" 

450 SYS "OS_Sprite0p",256+35, sprite’," 
vruler®, *vruler?*,i 

500 NEXT if 

510 FOR if=1 TO 3 

520 SYS *OS_Sprite0p",256+25, sprites, * 
vruler"+STRS (it) 

530 NEXT if 

540 ; 

550 S¥S *OS_SpriteOp*, 256-12, sprices,.* 
Sprites":SYS “Hourglass_Ofé" 


10 REM >!RunImage 

20 REM Program Text Rulers 

30 REM Version A1.00 

40 REM Author Mark Moxon 

50 REM RISC User Aprii 1992 

60 REM Program Subject to Copyright 
70 REM NOT Public Domain 


$0 ON ERROR PROCwimperror:END 

100 PROCinic 

110 REPEAT 

220 SYS "Wimp_Poll®,0,block$ TO reason 


130 CASE reason’ OF 
160 WHEN 2:SYS “*Wimp_CpenWindow",, blo 


150 WHEN 3:SYS “Wimp_CloseWindow",,bl 
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ock$ 
160 WHEN 6:PROCmouse_click 
170 WHEN 9:PROCmenu_selection 
180 WHEN 17,18 
190 IF block$!16=0 THEN quit%=TRUE 
200 IF block’!16=&400Cl THEN PROCvdu 
210 = ENDIF 
220 ENDCASE 
230 UNTIL quick 
240 SYS "Wimp_CloseDown", task#,&485342 


250 END 
260 : 
270 DEF PROCwimperror 

286 tblock=ERR 

290 ${block+4)=REPORTS+" (internal er 
ror code "+STRS(ERL)+"}"+CHRS (0) 

300 SYS "Wimp_ReportError",block$,i,"R 
ulers® 

310 SYS “Wimp_CloseDown", task$,&4B5341 
54 

320 ENDPROC 

330 : 

340 DEF PROCinit 

350 quitt=FALSE:hort=0:vertt=0 

360 DIM block$ £200, o>m$ &200,dc% 10 

370 DIM sp$ 11090,sp1% i0,sp2% i0 

380 SYS "“Wimp_Initialise", 200,&4853415 
4,"Rulers" TO ,task? 

390 SYS "OS_SpriteOp",256+10, sp%, “<Rul 
ers$Dir>.Sprites" 

400 Sspit="hruler":Ssp2%="vruler" 

410 tblock$=-1:block$!4=0:block$!8=0 

420 block$!12=68:5lock$!16=68 

430 block$!20=&3002:$ (block+24) »*!rui 
ers" 

440 SYS "Wimp_CreateIcon",, block$:blen 
$=3 

450 PROCcreate_menu [bmt, endt, "Rulers* 

460 htickt=ends 

470 PROCiter{endt, *Horizontal",,5,-1) 

480 vtick$sends 

499 PROCizemiend’, “Verricai*,0,0,-2) 

500 PROCitem(end¥, "Qaic";9,2.-2) 

510 PROCvdu:hsizet=shsizes:vsizet=sysi 
zet 

520 PROCcreate_ruiers 

530 ENDPROC 

540 : 

550 DEF PROCVdu 

560 SYS "“OS_ReadModeVariable*,-1,i1 20 

» insize’ 

570 SY¥S *OS_ReacModeVariable",-1i,4 7 
10% 

580 lhsizeS=lhsizes<<et 

590 SYS "OS_ReadModeVariable",- 1,12 70 
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,ovsizet 1050 PROCitem(end$, "Vertical", verts, 
609 SYS "OS_ReadModeVariable",-1,5 TO Q,.-1)} 
188 1060 PROCvruler (16,1000-vsizet, 48,10 
610 lvsizet=lvsizet<<e% 00) 
620 shsizet=(2*lhsizes) /3 1070 = ENDIF 
630 svsizet=(2"lvsizes} /3 1080 WHEN block$!8=4 AND {(block%!12=ww 
640 ENDPROC % OR block$!12=hw%} 
650 : 1090 PROCdrag{biock$!12) 
660 DEF PROCcreate_rulers 1100 WHEN block#!8=1 AND (block#!i2=vw 
670 block®!28=&80000012:block#!32=&207 $ OR Diock$!12=hw’) 
0207 1110 = PROCtoggle(block#!12) 
680 block$!36=0:block$!40=0:blockt!44= 1120 ENDCASE 
-32 1130 ENDPROC 
690 block’!48=160*16:block$!52=0 1140: 
700 block$!56=0:block$!60=6<<12 1150 DEF PROCmenu_selection 
710 block’! 68=0:block$!84=0 1160 SYS “*Wimp_DecodeMenu", ,om%, block’, 
720 SYS “Wimp_CreateWindow", , block’ TO act 
hwt 1170 SYS "Wimp_Get PointerInfo",, block’ 
730 'blockt=hw8:block$!4=0:block&!8=-3 1180 adjust$=dlock$!8 AND 1 
2 1190 CASE $dc% OF 
740 block$!12=160*16:block$!16=0 1200 WHEN “Horizontal” 
750 block’! 20=&3112:block$!24=sp1% 1210 hort=hor$EOR1:end$=ntick’ 
760 block$!28=sp%:block$!32=6 1220 PROCitem(end%, "Horizontal", hors, 
770 SYS “Wimp_CreateIcon", ,block’ 6,-1) 
780 block’! 28=&80000012:block$!32=£207 1230 PROChruler(0,900,hsize%, 948) 
0207 1240 WHEN “Verticai° 
730 dDlock$!36=0:block$!40=0 1250 vertt=vertS50RL:endt=vtick’ 
800 block$!44=-32*80 1260 «= PROCitem(endé, "Vertical", vertt,0 
810 block’ !48=32:block%!52=0 +1) 
820 block’!56=0:block$!60=6<<12 1270 = PROCvruler{1€é,1000-vsize’, 48,100 
830 block’! 68=0:block$!84=0 0) 
840 SYS *Wimp_CreateWindow",, block’ TO 1280 WHEN "Quit": quit%=TRUE 
vt 1290 ENDCASE 
850 !blockt=vw$:block$!4=0:block’!8=-3 1300 IF adjust%=1 THEN PROCdisplay_bar_ 
z*80 menu (bm$, blent ,mx3) 
860 blockt!12=48:block$!16=0 1310 ENDPROC 
870 block$!20=&3112:block$!24=sp28 1320 : 
880 blockt!28=sp% :block$!32=6 1330 DEF PROChruler {mx%, my$,mxx$, mxy$} 
890 SYS "Wimp_CreateIcon",, block’ 1340 IF hor%=1 THEN 
$00 ENDPROC 1350 !block’=hw$:block’ !4=mx%:block$!8 
930: =my% 
920 DEF PROCmouse_click 1360 block$!12=mxx$:block$!16=mxy% 
930 CASE TRUE OF 1370 block’!20=0:block$!24=0:block$!28 
940 WHEN block$!8=2 AND block$!12=-2 =-l 
950 = mxt=!block$ 1380 SYS "Wimp_OpenWindow", ,blockt 
S60 PROCdisplay_bar_menu (bat, blent,m 1390 ELSE 
x) 1400 !tblockt=hws 
970 WHEN block#!8=4 AND block$!12=-2 1410 SYS "Wimp_CloseWindow", , block’ 
980 IF hor$<>l THEN 1420 ENDIF 
990 hor%=1l:end$=htickt 1430 ENDPROC 
1000 PROCitem(end’, “Horizontal”, hor’ 1440 ; 
+0,-1} 1450 DEF PROCvruler(mx%, my$, xx, mxy$} 
1610 PROCHruler{0,900,nsize$, 948) 1460 IF vert%=i THEN 
i028 = ENDIF 1470 tblock&=vwé:block#!4=mx%:block$!8 
1030 IF vertt<>i THEN ory? 
1049 0s vert$=l:endt=vrick’ continued on page 30 
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Making a Clear Impression 


Peter Merton reviews two new books for Impression users. 


wo new books, First Impression and Good 

Impression, have been been produced and 
published by Stephen Ibbs of Word 
Processing. Created with Impression II they 
demonstrate in themselves that Computer 
Conceptsé document processor is a more 
than adequate tool for writing and 


First Impression 


First Impression is presented as an 
Impression II look-alike, right down to the 
smart ring binder and black slip-in box, 
presumably signalling Computer Conceptsé 
endorsement of the product. Two discs of 
sample documents are also included. 


For such a book to 
find a useful niche 
alongside the official 
manual it must meet 


three distinct 
challenges. It must cater 
for the needs of 


absolute beginners, 
starting from scratch 
and taking nothing for 
granted. It must shed 
light on those dark 
places where the 
operation of the 
program is obscure or 
intimidating or the 
manual fails in clarity 
and it must serve as a 
corrective to the bad 
habits of those self- 
taught ‘Impressionists’ 
who despise manuals. In all these areas First 
Impression demonstrates real merit. 


The needs of beginners are met through 
a step by step guide to using Impression. 
Chapters cover starting up the application 
and beginning, saving and printing a 
document. Text insertion and editing, and 
the application of styles, rulers and effects 
are carefully described, as are the use of 
frames and the inclusion of graphics. The 
design of master pages and chapters 
receives minute examination. Each chapter 


presenting quality books of over 200 pages. 
Attractive and consistent style and layout 
are maintained, and there are many 
excellent half-tone illustrations. First 
Impression is described as a tutorial guide, 
while Good Impression is a compendium of 
design ideas and techniques. 


concludes with a task to be done at the 
keyboard, and a list of the competences the 
student should expect to have acquired 
before pressing on. The approach is 
structured and the order is logical but there is 
a price to be paid in an inevitably pedestrian 
style. However, the 
author never tires of his 
task or sinks into an 
unacceptable dullness. 


The tutorial section 
of the book is 
supplemented by a series 
of eleven appendices in 
which the user is guided 
through the preparation 
of different kinds of 
documents, from a 
simple i ire toa 
complex table, and it is 
here that First Impression 
aspires to meet that 
second criterion - casting 
light on daunting or 
difficult operations. 


To illustrate the 
point, it has to be conceded that the 
production of boxed tables is something of 
an after-thought in the development of 
Impression, and I suspect that there might 
be a subsection of Murphyés law which 
states that if a new feature is introduced into 
an application after the completion of the 
manual it will never quite receive the 
coverage it deserves in the new issue release 
notes. So it is with tables in Impression. The 
basic software problem is that unlike many 
of its PC rivals, Impression does not employ 
the Return character to terminate the 
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application of a style; the knock-on effect is 
that the creation of tables is far from easy, 
requiring, for a complex table, the 
overlaying of several different styles. From 
this unpromising starting point Stephen 
Ibbs offers some valuable suggestions which 
raise this particular function out of the 
almost impossible into the merely tedious! 


Comments 


ee 
live up to expectations, We believe 


Sproggets ‘This product has always failed to 
that the range should be scrapped. 
Pinjacks Working well Initial response appears favourable 


Twistdrives Tests positive Launch date is planned for the end 
of 1991 and is on 


Finally, First Impression has something 
useful to offer to the re-training of old hands 
who have fallen into bad habits. I have been 
using Impression from the very first version, 
and I have always been intimidated by the 
imagined complexity of producing new 
master pages. The consequence is that I 
have frequently wasted hours modifying 
one of the default styles, when (as I now 
see) I could much more profitably have 
started from scratch. Another welcome 
discovery is that rulers, used separately 
from styles, can also be a real bonus. I have 
tended to neglect them because unless 
integrated into a style, they are not provided 
with key short-cuts, and I find this irksome. 


Good Impression 


\ 


PRODUCTS 


GLOBAL 


In spite of its name, Good Impression is 
not primarily a book on the subject of good 
style, and it in no way supersedes “DTP at a 
Glance” supplied as part of the Impression 
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Will you be my 
valentine? 
Tides using dingbat characters 


I am sure I am not alone in needing some 
corrective training, and I do not doubt that 
other seasoned Impressionists will find help 
with areas of the software they have 
previously overlooked or dismissed. 


If the book has a weakness it is the choice 
of some rather arbitrary cut-off points in the 
material covered by the tutorial section. I 
noted one in particular which I think is 
unfortunate: only the basic print options are 
covered. In my own work I produce a 
seemingly endless succession of A4 sheets 
single-folded into an A5 pamphlet. An 
option exists in the print dialogue to 
facilitate this but because I did not find the 
manual very clear I spent many months 
doing it the hard way - reducing on the 
photocopier and pasting up - before I 
discovered how to persuade Impression to 
do it all for me at the press of a few buttons. I 
would not have acquired this new wisdom 
from Mr Ibbs. Other omissions include spell- 
checking, auto-loaders, hyphenation and 
abbreviation lists, and the creation of indices 
and contents lists. Printers are not discussed, 
and there is no coverage of monitor types or 
screen modes, fundamental though these are 
to the serious use of Impression. But of 
course there have to be limits, and these are 
inevitably dictated by the authorés own 
perspectives just as my comments have in 
turn been dictated by mine. Verdict? A bit 
overblown in presentation, but definitely 
recommended. 


package. Rather, it announces 
itself as an exploration of 
design ideas and techniques, 
although it could very 
appropriately have been 
sub-titled “One hundred 
things you never knew you 
could do with a Dingbat!” 


The demands of good 
style are not ignored, but 
the core of the book is an 
exploration of the variety of 
artwork which can be produced out of 
nothing more exotic than the outline fonts 
supplied with Impression, including those 
ubiquitous Dingbats. If you havenét met 
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IMPRESSION 


“The best and most comprehensive guide” COMPUTER 
Not just a book but an integrated training pack covering borders, frames. graphics, 

tulers, styles, tinted backgrounds, superimposed text, tables and much, much more. AP Ny ROVE D 
Supplied in an Impression binder and case it contains: Ay CONCEPTS 


Step-by-step instructions * practice tasks Ny Catena: ae 
hints and tips throughout * clear explanations 


13 tutorial chapters + 11 chapters designing sample documents 


Complete package only £29.95 with free p&p (UK only). 


And now.. GOOD IMPRESSION a complete book of ideas, designs and techniques. 


This book is crammed with design ideas, and how to achieve them in Impression. Create amazing borders, logos, letterheads, 
invoices, business cards, unusual headers, drop-caps without having to draw anything. Use dingbats creatively, superimpose 
text, produce word squares, sewing patterns, class registers, book covers. Supplied complete with disks of every design 
illustrated in the book so that you can modify them to suit your own requirements. 

Complete package only £26.95 with free p&p (UK only). 


Please send cheque or official order payable to: 


Word Processing, 65 Milldale Crescent, Wolverhampton, West Midlands, WV10 6LR 


IiTF@iitter 


Transfer, the NEW utility that lets you copy text from any icon in any RiscOS application and transfer it to 
any other. 


The copied text can be inserted into other text, or it can replace it. You will find many uses for Transfer as 
it makes the contents of practically all field or writable icons, ‘drag-able’ between applications. It also lets you 
drop the text into documents as well as icons. An obvious use would be to grab a name and address from a 
database and deposit it into a word processor, (or even another database). 


Transfer is itself, a RiscOS application and sits on the icon bar. A simple menu gives you complete control 
of its actions. 


It is simplicity itself to use. All transfers are carried out by mouse clicks. Point and click at the text you want, 
then point and click again to deposit it. It is invisible to applications and does not interfere in any way with 
their operation. Transfer will work on any Archimedes series cornputer. 


Transfer is only available from Apricote Studios, 2 Purls Bridge Farm, Manea, 
Cambs, PEISOND (035 478) 432 


caeate £8.95 


inc. VAT & p&p VISA 
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them, perhaps | should explain that 
Dingbats are a whole family of signs and 
symbols presented as an alternative font, 
and which can be accessed from the 
keyboard and built into printed text. As will 
be clear from some of the accompanying 
illustrations, Stephen Ibbs has promoted the 
humble Dingbat to a pivotal position in the 
creation of a new art form. 


Creative titles from converted outline fonts 


In presentation Good Impression stands in 
marked contrast to its companion. No 
software packaging overkill, but a slim spiral 
bound paperback accompanied by three discs 
full of samples and illustrations. The skills 
taught in the previous volume are taken for 
granted, and techniques are described with a 
far greater economy of words. 


The author begins with an apology that 
it proved impossible to give this second 
volume a clear shape and provide a index, 
and his difficulty is echoed in this review. 
The ideas simply tumble over each other 
without any clear sequence, and the book 
will serve most usefully not as a source of 
material for slavish copying, but the starting 
point for a radically new way of seeing. 


The fundamental point is this: because 
the Archimedes employs outline fonts which 
can be converted into Draw files, any 
character which can be displayed on the 
screen or delivered to the printer can be 
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presented as a smooth outline at any 
magnification. Impressionés Fontdraw 
utility was used to convert outline font 
characters into Draw files, and with 
Impressionés powerful enhanced graphics 
facility switched on, these characters can be 
enlarged, rotated, and re-proportioned. Thus 
groups of characters can be built up into a 
vast array of shapes limited only by the 
userés imagination. With text appropriately 
mixed in, the technique lends itself to sharp 
and eye-catching communication. 


And this is not all; Good Impression has 
some helpful advice on the production of 
eye-catching titles and the use of drop 
capitals. There is a useful section on borders, 
and there are directions for creating a simple 
Impression border using the Draw 
application. The creative use of shadows 
and tints is covered, and by way of 
illustration an array of school and business 
stationery is put on display. The three discs 
contain Impression files of all the artwork 
included in the book. 


In applying the lessons of Good 
Impression, I am sure that the author would 
not wish to imply that his way of creating a 
particular effect is the only way. For example, 
I noted that a whole page was taken up 
describing a complex sequence of 
manoeuvres for achieving an effect which 
could have been accomplished by nothing 
more elaborate than dropping a couple of null 
frames over the unwanted bits of an object. 


With that one small caveat I must state 
my conclusion. If you use Impression to 
make an impression, and provided you are 
willing to experiment, Good Impression 
represents good value for money. 


Product First impression 
Price £29.95 inc, VAT and p&p 
Product Good impression 
Price £26.95 inc. VAT and p&p 
Supplier Word Processing 
65 Milldale Crescent, 
Fordhouses, 
Wolverhampton, 
Wesr Midlands WVI0 6LR 


Both publications are also available from 
Beebug. 
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Improving the Quality of Half-Tone 
Printing on a Dot-Matrix Printer 
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by David Cawsey 


D ot-matrix printers can give disappointing 
results when printing half-tone sprite 
images which look good on the screen. This is 
partly due to the lower resolution (even with a 
‘high resolution’ setting of the driver), and 
partly due to poor reproduction of the grey- 
scale. This article will show how grey-scale 
reproduction can be improved for output to 
any printer; the 
illustrations are based 
on the application of 
this general method to 
a Star LC24/10 printer. 


We shall refer to 
the RGB colour model 
in which all colours 
are represented by a 
mixture of red, green, 
and blue components 
on a scale running 
from 0 to 255. Grey 
tones contain equal R, 
G, and B components; thus (0,0,0) 
represents black, (255,255,255) 
represents white, and (128,128,128) 
represents mid-grey. These values 
are stored in the palette of an image 
and the computer passes them to 
the monochrome output device - 
screen or printer; the aim is to 
present the eye with a correct 
impression of the grey tone (or the 
correct colour in the case of colour 
display, which we are not 
considering here). 


With a ‘high resolution’ setting, the Acorn 
printer driver caters for 64 grey levels; it tries 
to create the impression of a grey-scale by 
filling each 8X8 (64 dot) area on the print 
with a number of dots proportional to the 
sum of the RGB values. For example a palette 
setting of (128,128,128) causes the printing of 
32 black dots on the assumption that the eye 


64 grey level test pattern 
printed on Star LC24/10 


64 grey level test pattem 
printed on Deskjet 


will perceive a mid-grey; unfortunately the 
spreading of the individual dots is likely to 
create a ‘blacker’ impression than is 
intended. 


This can be demonstrated by printing a 
64 grey level test pattern on your printer. A 
suitable test pattern can be created using 
Draw as follows. With grid lock set, 
create a 0.25” by 0.25” square, filled 
with any grey you choose and no 
outline. Copy this 63 times, and drag 
the 64 squares into an 8X8 
arrangement. Now select the top left 
square and use the Style submenu to 
alter the fill colour to R, G, and B 
values of 252,252,252 using the arrow 
controls to the left of the colour bars in 
the Fill Colour dialogue box. Repeat 
this for the next square, with values of 
248,248,248 - and so on, reducing the 
values by 4 at each step. 
Note that the screen 
display will not 
reproduce the fine 
variation in grey levels, 
but they will nevertheless 
be saved as a palette with 
the Draw file, and when 
this file is printed the 
printer driver will 
attempt to reproduce all 
64 grey tones on your 
printer. 


Figure la shows the 
result of printing this test pattern on a Star 
LC24/10; for com-parison, Figure 1b shows 
the same image printed on an ink jet printer 
(the HP DeskJet). The ink jet creates a good 
impression of the grey scale except for the 
last 10 or so levels which appear equally 
black. The impact printer is far worse, with 
little discernible variation in tone over the 
blackest 32 levels. The inevitable result is 
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that any scanned image will be degraded in 
tonal quality when printed. This problem is 
a consequence of the use of a general 
purpose printer driver which has not been 
matched to the specificprinter; the printer 
driver _ itself 
cannot easily be 
modified and 
weé have to look 
for a method 
which will 


16 grey level scanned image 
printed on Star LC24/10 


compensate for the 
mismatch. One such 
method is detailed below. 


From the 64 elements 
of Figure la, one can pick 
out 16 squares which provide a reasonable 
tonal progression; these levels will not be 
equally spaced along the original 64 grey 
level scale, and will probably be 
concentrated at the paler end. This 
suggests a method of compensating a 16 
grey level sprite by modifying the palette; 
each of the the RGB values in the palette 
will be deliberately changed to ‘wrong’ 
values to compensate for the mismatch of 
the printer so that the required grey tones 
are printed. One should proceed as follows. 


Take the result of printing the test 
pattern (e.g. Figure la), and make a first 
estimate of a set of 16 squares (chosen from 
the 64) which will provide a reasonable 
progression from white (or rather the 
“white” that your printer prints) to black. 
Ideally the colour of each square should be 


1S grey level scanned image 
printed on Deskjet 


just distinguishable from its neighbours. 
Remembering how the test pattern was 
produced, note down the RGB values for 
the proposed sequence. Test this estimate 
by producing a strip of 16 squares with 
these RGB values, using a similar 
technique to that used for the original test 
pattern (or using the facilities of Draw to 
copy squares from the original pattern and 
drag them into position). Print this strip 
and scrutinise the result. If necessary make 
further small adjustments until the result is 
satisfactory. 


A selected set of 16 grey levels 
from Figure la provides the 
following sequence of RGB 
values: 


Retoned image printed on Star 
LC24/10 


Each of these single numbers represents a 
triplet, thus 188 represents (188,188,188) on 
the RGB scale. Note that this sequence is 
only an example - you will need to choose 
your own sequence of values depending on 
your printer’s output. 


This sequence for example assumes that 
the left-hand block in the third row of Figure 
la appears mid-grey. That block has only 17 
black dots out of 64 (rather than the original 
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32 referred to above, which is far too black), 
and the block was obtained by sending a 
palette setting of (188,188,188) to the driver. 
This is the palette setting which must be 
used to replace (128,128,128) in the palette of 
any image which is to be compensated for 
when printing. Essentially we make mid- 
grey in the palette paler than it should be, in 
the knowledge that the printer will darken it. 


An appropriate sequence can be derived 
for any printer by following the same 
method and the sequence provides a 
translation table for creating the new 
palette. By loading the 16 grey level sprite 
into Paint we can reset the palette values to 
the new sequence and save this version as a 
new file. The procedure is to select each of 
the 16 colours in turn, and then use the ‘Edit 
Palette’ submenu on the ‘Paint’ menu to 
change the R, G and B values to the 
appropriate values in the new sequence. The 
sprite will look less realistic on the screen, 


1480 block?!12=mxx%:block$!16=nxy? 
1490 block$!20=0:block$!24=0:block$!28 


SYS “Wimp_OpenWindow", , block’ 


pany 


Poy 


SYS “Wimp_CloseWindow",, block? 
ENDIF 
ENDPROC 


a nd 


- 
won on on un on un + 


~ 


1570 DEF PROCdrag (winds) 
1580 blockt!4=winds 
1590 SYS “Wimp_GetWindowOutline", , block 


1600 !blockt=windt:block$!d=1 

1619 SYS “Wimp_DragBox", ,dlock’ 

1620 ENDPROC 

1630 : 

1650 CASE wind’ OF 

1660 WHEN hws 

1670 TF hsizet=lnsize’ THEN hsizet=sh 
size’ ELSE hsizet=lhsize’ 

1680 = Iblock$=hwt 

1690 SYS “Wimp GetWindowState”", , block 


1702 «=PROChruler(block$!4, block!8,hsi 
ze’+block?!4, block$!16) 
1710 WHEN vw 


Improving the Quality of Half-Tone Printing on a Dot-Matrix Printer 


but when printed it should give a 
significantly improved result. This is 
illustrated by the following example. 


Figure 2a was printed from an 
unmodified 16 grey level sprite on a Star 
LC24/10 via the appropriate ‘high 
resolution’ setting of !PrinterDM. For 
comparison, Figure 2b was printed on a 
DeskJet. The palette was then modified as 
described above, and Figure 2c shows the 
improved print obtained on the Star 
LC24/10. Clearly the quality still falls short 
of the DeskJet, but nevertheless the 
improvement over the original is marked 
(though this may not be so obvious once 
these pictures are reproduced in this 
magazine). The scope for improvement will 
obviously depend upon the initial 
performance of the particular printer. 


The magazine disc contains the test Draw files 
and Palette files referred to in the article. RU 


Desktop Character Rulers (continued from page 23) 


1720 IF vsize$=lvsize$ THEN vsizet=sv 
Size’ ELSE vsizet=lvsize% 

1730 !Dlocké=vwt 

1745 SYS "Wimp_GetWindowState",, bloc 
& 

1750 =PROCvruler{block$!4, block$!16-vs 
izet, block§!12,dlock#!16)} 

1760 ENDCASE 

1770 ENDPROC 

1780 : 

1790 DEF PROCcreate_menu|menu$, RETURN e 
nd%, titles) 

1800 Smenug=titles :menu%!22=&70207 

1810 menus!16=11*i6:menu$!20=44 

1820 menus!24=0 :endt=menu&+28 

2830 ENDPROC 

1640 : 

1850 DEF PROCicem|RETURN end&,cext$,tic 
«%, last?, Link?) 

1860 tend$=tick§+ (last$<<7} 


*~ 


1880 §lendt+12) =textS:end$-=24 

1890 ENDPROC 

1900: 

1910 DEF PROCdispley_bar_menu (m%, 1%, x3) 
1920 SYS "Wimp_CreateMenu", ,mb, xt-64, 96 
+{1%*44) 

1930 ENDPROC 


AU 
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Flight Sim Toolkit 


Reviewed by Nathan Brown 


re you bored with the current batch of 

flight simulators: with the same old 
missions, and objects such as trucks, tanks 
etc? Well, now there might be a solution to 
your problem: the Flight Sim Toolkit from 
SIMIS, the creators of all the jet fighter 
simulations on the Archimedes. This package 
enables you to design your own flight 
simulation world, and includes a couple of 
example simulations to get you going. 


The packaging is surprisingly plain. The 
box contains two unprotected discs (meaning 
the game can easily be installed on a hard 
disc), a manual and a tutorial pamphlet. 
“What no full colour book on great fighter 
planes of the world?” I hear you cry: possibly 
SIMIS left the statutory tome out to keep the 
price down. Having said that, at £45 it’s still 
quite an expensive package. 


SHAPE 

The first application I tried was the 3D 
object designer Shape. When it is run you 
are presented with two windows: one is the 
object window where the fruits of your 
labour are displayed, and the other is the 
main toolbox. To get started I decided to 
load in the truck shape supplied, but all I 
was presented with was a red cross: hardly 
truck-like! However I zoomed in, 
discovered the shape and set about 
redesigning it. After about an hour of trying 
to metamorphose the truck into a 
Lamborghini Countach I gave up, deleted 
my object, which by now resembled a 
collapsed electricity pylon, and picked up 
the manual. 


The manual is laid out in an easy to 
understand fashion and after reading only 
half of it I could get to grips with the 3D 
editor. In the editor you design an object in 
the main window, but can only do so one 
dimension at a time; you can then call up a 
window with a three dimensional 
representation, and rotate and scale the 
object. Each object consists of a multitude of 
three or four sided polygons that can be ina 
variety of colours. 
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To draw a polygon you plot three or four 
points and then join them together, which 
must be done in a clockwise fashion so that 
the shapes are visible from a specific side. 
So, for example, if you designed a tail 
surface you would have to draw two 
polygons, one for the left view and one for 
the right. The more realistic you want your 
object the more complicated the process will 
be, and it will take more time to plot. 
Additionally all objects have three visual 
states, near, medium and far, which 
determine the shapes plotted when the 
object is at different distances. The far state 
should ideally be the simplest shape (i.e. it 
should contain the least number of 
polygons) to keep the speed of the game toa 
reasonable rate. 


MODEL 

The next task after you have created all 
your objects is to give the aircraft their flight 
characteristics with the Model application. 
With this you can define the wing size, 
centre of gravity, engine power, fuel tanks, 
undercarriage, weight and drag factor of the 
aircraft. To get the best out of this tool I 
found I had to experiment with the options. 
You can also set the ordnance levels in 
which you are limited to the usual cannon, 
rockets and missiles that are on most other 
simulators, but this I found disappointing. It 
would of been nice to have had a larger 
selection of weapons to choose from. 


COCKPIT 

The Cockpit application is used to create 
what you see when inside the plane. It 
presents you with two windows: the first is 
the actual cockpit and the second contains 
various instrument icons. All you have do to 
set up your cockpit is simply drag these 
instrument icons into the main window. 
Some can be re-scaled to suit personal taste. 
Using Paint you can then design a large 
sprite to be the background of the 
instrument panel, putting black squares or 
circles where the instruments go. This 
needed constant editing in Paint to get it just 
right. The one problem I found with this 
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User Public Domain Library 


Our Public Domain discs contain as near as possible to 800k (and not less than 700k). Each disc includes a ‘Read Me’ file, and there are some 
instructions with the programs. The discs are offered as seen and are available to RISC User members ondy for the new low price of £1.60. 


To order tel. 0727 40303, fax 0727 860263, or write (quoting memb. no) to: RISC Developments, 117 Hatfield Road, St. Albans, Herts ALI 4JS. 


DEMOS 
PP)12 Discs sound and graphics demos from 
Hugo Fiennes of the Serial Port. All $ are 
stunning examples of what the Arc is capable. 
PD21 Dixe3 demos, Balls, Balls2 and BIA- 
Tetris. The latter is a game as well as a demo, 
P1D22 Dise3 demos, Noah, Chips and Demol. 
PD24 Dise4 demos, Bounce, Crimbo, 
ColDemo and Rotate 
PD24 Dise3 demos, Demo, Gopher and 
Overscan. 
PD25 Dise4 demos, Desktalls, DudsDemo, 
Fepcaes, and Z-Brother. 
226 DIs€ 4 demos, Sister, SkullDemo and Wibble. 
PD27 Dise2 demos, and Windows 
PDS Dise3 demos, Leapin' Fish, SinDemo 
and Swallow. 

PD37 Dise, massive four-part demo called 
peg ao bay ig This has to be the best demo 
yet . Amazing! 

PD42 Dise4 demos, AceDemo4, Cubitus, 
Scorpius and 3D_RayPic. 


GRAPHICS 

PD13 Disc The !Projector application - 
displays films created with the Ace Computing 
Mogul package. Six example films are included. 

PDI1K Dise A program which displays several 
still and animated ray traced pxtures. 

P33 Dise Contains a program that displays 
several still and ynimated ray traced pictures. 

¥D44 Disc, selection of fractal generation 
programs and utilities, 

PD45 Dise 2 applications, Creator and 
Translator, allowing exchange and display of 
graphics picture files between Archimedes and 
other wters. Also some high quality demo 
pictures plus a mode converter and a mode 
utility allowing multisync modes to be 


yed on a non-multisyne monitor 


DRAWING AND ART 


PD15 DiseArctist+ and BigM, both 256 colour 
art packages, along with Design, a symmetrical 
pattern 

PD41 Dise4 applications: ‘Display’ allows the 
deploy of Deew hes by dragging them inoa 
window. "Dra "isan oriented 
driwing package that may be used as an 
alternative to Acorn’s Draw supplied with your 
Archimedes or A3000. Drawplus has many 
enhancements over Draw. Drawstrip’ is a 
penn to enable the easy creation of function 

sirips using Draw. ‘Drop’ enables Draw files 
to be routed in 3D and then saved again in 
their new perspective. 


EDUCATION 


PD 14 DiseigeG, a student register system 
which replaces classroom registers. A system 
for sareging Oe recording and reporting 
required by the National Curriculum and data 
files for Pipedream for NC statements of 
attainment in science. 


MUSIC 
PDOL Disesoundiracker playroutine plus the 
following tunes: Aces-Hi, ‘Acidbat 2, Afl, Alf, 


ArNoise, Axell, Backpopped, Big, Blitzwing, 
Blizzard02, 


PDO2 Disc soundiracker playroutine plus the 
following tunes: BatMix, Bobby, Brill, Burning. 
Chartmix, Chipgene, Demo2. 

P1DO3 Disc soundiracker playroutine plus the 
following tunes: Confusion, Crack, Criminal, 
Dear, Demons, Dns, Elephant. 

PDO4 DiseSoundtracker playroutine plus the 
following tunes; Docl, Punky, 

Electric_2, EndTheme, Enutomed, Equinoxe5, 
FinalTFDMI, FinalVis. 

PDOS Disc Soundiracker playroutine plus the 
following tunes; Fyc, une, Hello, 
sage my Huba, Humanoid. Hunters, 

Hymn, . Igarun, IntoB. 

PDO6 DiseSoundiracker playroutine plus 
these Lunes: Jazzid, Jmj_China, LastNinja2, Like, 
Magneticd, MegaForce0, Minimize, Mod, New_Biz, 

PDO7 Distsoundtracker playroutine plus 
these tunes: MyWay, Nothing-2, Qooerr, Outrun, 
Pacman, Pat, PetShop, Pretend, SaySaySay2, Steeve 

PIP16 Dis 235 runes for loading into the music 
package Maestro, variety enough (o suit most tastes. 

PDO8 Disc Soundiracker A gs plus 
these tunes: Setrox, Tarzan, TGM, TheModel2, 
‘TjatMikes, Toccata, Unit, Vprtex, We're, Yezz. 

PIN Disesoundtracker playroutine plus these 
tunes: Acid House, Bananas, Cambod, Crok, 
Cute, Dallas, Deadlock, Dragnet. Yazoo. 

PD10 DiseSoundtracker playroutine plus the 
following tunes: DemoSmash, FFSound, Five, 
GSCTheme, HiEnergy, Oxygene2, Piano, 
PopCorn, PumpUp. 

PD11 Disesoundtracker playroutine plus the 
following tunes: Rescue, Rockit, Round,Scratch, 
Scratch2, Show, SmokeOn. 

PD40 Dise the Jukebox playroutine plus the 
following Tracker tunes: Acid House, 
TeddyBears, Canon, Breathe, Six2, Rag It. 

PD43 Dise An application called Coconiser, 
pr 2 bear nes er, that allows the creation 

tunes by sequencing di = sampled 
sounds, Denn tunes dpa a the disc, 

PD46 DiseThe Jukebox playroutine plus the 
following Tracker tunes: Beginning, Blue Peter, 
Frog Song, IcelceBaby, Monty Mix, Over The 
Bow, Rawhide, SkyXmasMix, Thunderbird 

PDT Disc, selection of SoundTracker and 
Tracker playback routines and utilities including 
a keyboard and spectrum analyser 


SAMPLER DISC (PDS1) 
Contains the following sample programs from 
our Public Domain Software La 
SoundTracker, 


Rotate, 


TRICKS AND NOVELTIES 


PD 17 Dis, collection of 27 amusing novelty 
programs, Some produce the weirdest effects! 
PD32 Diseconiains an application called 
Cookie. When run, if puts up a window 
containing a ‘fortune cookie’ or a well-known 
saying or piece of philosophy. Be warned! Very 
addictive once seen, also rather zany not to 
mention, occasionally saucy! There are some 
6000 sayings. Also on this disc is a scroll text 
demo with soundtrack music called Invade that 
also features a space invaders game within it. 


UTILITIES AND APPLICATIONS 

PD28 Dise2) utilities of various types. There 
is something here to everyone. Space 
Shoce aed pear Wal leeanins coe dee ie tk 
is, IstFile, ASm2, CloseUp, Cope Dir, Diy 
Drawink, Dustbin, Filetypes, FileUtils, Fi 
Keys, Loadprogs, MultiPrint, NewBar, NewCodes, 
PD _lmpress, PrinerTx, ProgCale, and Set_Type 

PD31 Dise}7 utilities and applications. Plenty 
oleic per ay ew deci e 

favour with most people. Bri jon 
the list is as follows: Address Book, Address 

Labeller, DiscSpace Display. Deslane Calendar, 
Cassette Inlay Printer two of these! , DFS Disc 
Reader, Automatic Application Creator, Arc 10 
Psion Transfer, ROM Speed-Up, STD 
Codefinder, System Utilities, Trash Can, Front 
end for Twin, Front end for View, Volume 
Controller, Control of Pointer by keys. 

PD3S Disey5 utilzies and applications. These 
are a 1st Word Plus file convener, 2 Ist Word 
Plus printer driver for Star LC200, a tem outliner 
: a hypertext program (like Genesis), 
a CD database, a video tape database, CMOS 
RAM saver and loader, disc sector editor, fast 
formatter, font printer, file save reminder, a 
COPY options setter, and TEXT to DTPfile 
converters, plus 3 print spooler, 


CLIPART AND PICTURES 
PD29 DiscOver 4 megabytes of Sprite piaures 
which can be used as dan to load rao DTP cr 
use in your ms. The files are naturally in a 
compressed form and the disc contains the file to 
uncompress them plus instructions. 

PD30 Discover 2 megabytes of Sprite clip art 
and Draw files to load into DTP or use in your 
programs. The files are naturally ina 
compressed form and the dise contains the file 
to uncompress them together with instructions. 


FONTS 


P35 Diseeleven PD outline fonts for use in 
RISC OS applications such as WP and DTP, 
These are, Stencil, American iter, 
Bodoni, Brushscript, Cooper Black, Fritz Quad, 
Garamond, Hull, London, Optima and Revue. 


COMMS 


PD34 Discarcterm3, a full comms — re 
package. Arcl00, a scrolling text terminal. 
Grapevine, another eaten text terminal but 
roulti-tasking, TaskData, a multi-tasking viewdata 
comms package. Download, an application for 
transferring per Sysop pala nip ie serial 
port. Timer, a utili on-line time 
and call cost, The version of Sparkplug, the 
file decompression program. Also a complete set 
of programs for running a bulletin board sysem 
on your Archimedes. 


GAMES 


PD19 Dise 9 games: Adevnture, Battle, 
Battleships, Connect4, Darts, Fish (Pelmanism), 
Pruit Machine, Golf, Hangman and Impact. 
PD20 Dise)2 games: Invaders, Line Of Five, 
Othello, Pelmanism, Rocks, Rubik Cube, Simon, 
Solitaire, Sar Trek, Tetris, Tile Trial and Yahizee. 
PD39 Discs games: Pac Man (in a window’), 
Arc Patience, Breakout (inside an icon"!!), 
Creepie esp ra Pelmanism and 
International Golf (Brilliant!) 


Flight Sim Toolkit 


application is that very few of the dials have 
numbers or markings on them when you 
run the game; any text or numbers must be 
put on the panel using Paint, but it is up to 
the user to decide on the level of realism 
required. As well as the instrument panel, 
the HUD (Head Up Display) can be changed 
to give varying amounts of information. 


WORLD 

World is the final tool, and is also the 
easiest one to use. Like Shape it presents you 
with two windows, one of which is the tool 
box and the other of which is the map of the 
world you are going to create. The world 
basically consists of a large square of your 
chosen colour, so if you wished to create a 
sea simulation as suggested in the manual 
you would make the “land” a blue colour 
and create green island polygons. You would 
then place the polygons on the blue to give 
the impression of an island. Each shape you 
have created can be dragged into the map 
window and positioned, copied and rotated 
until you have made up your world. Each 
item, once dragged in, has to have some 
options set for it, like whether the object is a 
hangar, a SAM, an AA gun, an enemy, part 
of the scenery etc. Once everything is set you 
are ready to go. 


The directory structure of the game you 
create is quite logical, with the shapes in one 
directory and the aircraft data in another. 
Once you run your game, if any problems 
do exist the game will stop and produce a 
text file with an error list. These are in plain 
English and are very simple, making 
solutions to problems quick and easy. It’s a 
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good idea to start by playing around with 
the two simulations supplied on the discs, 
changing the landscape or aeroplane 
performance as you wish. 


If you have a sound sampling board or 
Oak Solutions Arc Recorder, then you can 
sample your very own sounds for use in the 
game. My own attempts were somewhat 
unsuccessful, but after toiling over a hot 
mouse for a few hours I was ready. Donning 
my mirrored sunglasses, putting on the Top 
Gun theme music at full volume and 
turning the lights out, I prepared to go forth 
and do battle. Unfortunately, I had to take 
the sunglasses off because I couldn't see the 
mouse, I had to turn the music down 
because the neighbours complained, and to 
cap it all my plane flew like a toilet and kept 
crashing into the ground. However, after 
several more attempts at designing I came 
up with an airworthy craft and a half decent 
scenario; somehow it lacked the professional 
look that SIMIS give their games, but overall 
it wasn’t too bad. 


CONCLUSION 

It’s hard work to begin with, but if you 
are determined enough you should be able 
to create a very good simulation. The Shape 
application could be improved in my 
opinion; something like Illusionist’s three 
window display with two side views and a 
plan view window would make editing 
much easier. The windows should 
automatically open up when you load a file 
into the application, and you should be able 
to save a sprite directly from Paint into the 
Cockpit window. I think I expected a more 
flexible package from the gentlemen at 
SIMIS - for example it would be nice if more 
items were definable, such as engine 
position, operation, weapon types and effects. 


In conclusion, I would say that if you 
don’t have a simulator yet then it would be 
wise to look at the current batch before 
considering the Toolkit, but if you are bored 
with all the usual simulations then this 
package is a good solution. 


Product Flight Sim Tooikit 

Supplier SIMIS Led. 
26 Chittys Walk, Keens Park, 
Guildford, Surrey GU3 3HW. 
Tel, 0483 233048 

Price £44.95 inc. VAT AU 
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by Lee Calcraft 


| nany C program it is essential that all errors 
are properly handled. This is no less the 
case when writing Wimp programs using 
RISC_OSLib - for although many functions are 
provided for the purpose, it is up to the 
programmer to apply these appropriately. If 
you do not, then your program may crash 
unaccountably after long periods of good 
behaviour. 


THE os_error STRUCTURE 

Most Wimp functions do not handle their 
own errors, but pass them on by returning a 
pointer to a standard os_error structure - or a 
NULL pointer if no error occurred. 


Normally there is no need to read the 
contents of an error structure directly, but for 
completeness, it is defined as follows: 

typedef struct 


int errnum; /* err no */ 
char errmess[252]; /* err mess */ 
} OS_error; 


The message is null terminated. 


wimpt_complain() 

In almost all cases where a C function 
returns an error pointer, it is necessary to 
respond to the error in one way or another 
(unless it occurs in a redraw loop, when 
reporting it would cause an infinite loop). One 
of the most straightforward ways to report an 
error in a Wimp program is to wrap up the 
call using the function wimpt_complain(). For 
example: 

wimpt_complain(wimp_close_wind(w) }; 
The function wimp_close_wind() returns a 
pointer to the os_error structure, and 
wimpt_complain() takes this pointer as a 
parameter. If an error occurs when 
wimp_close_wind() is called, wimpt_complain() 
will report it in a standard error box with the 
task name in the title bar, and will wait for the 
user to click on an OK icon before allowing, 
things to proceed. 


If you want to experiment, you could try 
to close a window with a handle of -1 for 
example, in response to clicking on one of the 
menu entries in the Demo program. 


The function wimpt_complain() is used for 
reporting errors in cases where your program 
can proceed in spite of the error. But it will 
often be the case that when such an error 
occurs, your program will need to respond 
accordingly - for example if you are trying to 
extend memory so as to be able to load a long 
file, an ‘out of memory’ error would mean that 
the loading process should be aborted. To 
achieve this you can use something like: 

if (twimpt_complain(some_function{ ))) 

/* success */ 

} 

else /* failure */ 

This works because wimpt_complain() 
passes on the os_error pointer. If it is NULL, 
then what follows the if statement is carried 
out, otherwise that which follows the else is 
executed. 


FATAL ERRORS 
We have been using wimpt_complain() for 
errors which are not fatal to the program. But 
for errors which would completely 
compromise a program, the alternative call: 
wimpt_noerr |) 

should be used. For example if you tried to 
open a dialogue box, but could not because 
the template was missing, or if a Wimp 
window would not open. If an error occurs in 
a call wrapped in wimpt_noerr(), the user will 
get a message along the lines of: 

<taskname> has suffered a fatal internal 

error ( <messege> ) and must axit 

immediately 
and the program will be aborted. Untrappable 
fatal errors may of course also occur. These are 
handled by signal handlers set up by 
wimpt_init(), and give rise to the message 
“<taskname> has suffered a fatal internal 
error (type= <signal>) and must exit 
immediately”. 


wimpt_reporterror() 

Another alternative is to use 
wimpt_reporterror(). This works in a similar way 
to wimpt_complain() except that a second 
parameter allows you to customise the error 
box. The function has the following prototype: 
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volc wimpt_reperterror| 


(os_error*,wimp_errflags); 
There are three possible error flags: 


wimp_ZOK put in OK icon 
wimp_ECANCEL put in Cancel icon 
wimp_EHICANCEL highlight cancel 


Thus if you make the call with a flag value of: 
wimp_EOK | wimp_ECANCEL 

you will get both an OK icon and a Cancel icon 
- meaning that the user can opt to terminate the 
application or not when an error occurs. If we 
had also set the wimp_EHICANCEL flag, then 
the Cancel icon rather than the OK icon would 
have been highlighted. 


Unfortunately, this call has a couple of 
shortcomings. Firstly, it still reports even if it 
is passed a NULL pointer, and secondly it 
does not tell you which of the two possible 
icons the user selected. The first snag is easily 
fixed by testing for a NULL pointer before 
making the call: 

oS_error *e; 

if ((e=wimp_close_wind(w) ) !=NULL) 

wimpt_reporterror (e,wimp_ECANCEL) ; 


The second problem is harder to fix. You 
might think that you could use 
wimpt_last_event() to find out which icon the 
user selected, but unfortunately the user’s 
icon click is not the last event - since it results 
in the window being closed. You can however, 
still make use of wimpt_reporterror() if you 
want to display a Cancel icon on its own - the 
advantage over wimpt_noerr() being that you 
determine how the program is to be shut 
down. The only complete solution to the 
eps however, is to use the underlying 

WI directly (SWI Wimp_ReportError), and 
we will cover this in a future issue. 


MAKING SWI CALLS 


If you need to make a SWI call ina C 
program, you should make sure to use the so- 
called X form of the SWI, and wrap it up in a 
function such as wimpt_complain() or 
wimpt_noerr(). As you may know, all SWIs 
have two forms: the normal error handling 
kind, and the special X form (called with bit 17 
of the SWI number set) which returns an 
os_error pointer when errors occur. If an error 
occurs in a SWI call ina C program, and you 
have not used the X form, your program could 
terminate with a fatal error. 


The recommended way to do this is to use 
_kernel_swi(), which automatically uses the X 
form for you (unless you set bit 31 of the SWI 
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number). It is worth pointing out here that if 
you use the alternative call OS_swiX(), you 
must still set bit 17 in the SWI number which 
you supply to the call. 


GENERATING ERROR MESSAGES 

The function werr() allows you to generate 
error messages from within your program. The 
classic example to quote is the case of division 
by zero. If data entered by the user (in say a 
graph drawing program) results in a division 
by zero, then you need to inform the user, and 
abort the operation. The simplest way to do 
this is with something along the lines of: 


if (divisor==0) 


werr(FALSE, "Division by zero\ncalculat 
ion aborted”); 
return; 


The first parameter can either be TRUE, 
meaning that this is a fatal error, and that the 
program will automatically call exit(1) once 
the user has OKed the message - or FALSE, 
meaning that the program will continue from 
the next line. 


The second parameter is a pointer to a 
printfO-style format string. This means that 
you can use messages like: 

"File ts not located", filename 
The message may be divided into as many as 
3 lines of up to 40 characters each. 


In spite of the rare event used to illustrate 
this function, it is a very useful one, and can 
even be used in debugging - along the lines of: 

werr (FALSE, *X_len now = %d*,X_len); 
The only problem with this is that you have 
to click on OK before your program will 
proceed - though in a rapidly changing 
situation (e.g. within a for loop) this can be a 
distinct advantage. 


That is about all we have room for here. 
Next month we will take a look at the use of 
malloc() and flex(), and the allocation of 
memory within C executables. 10) 


saveas() ERROR 

Il am grateful to Graham Kemp and Richard 
Williams for pointing out an error in Part 7 of the series. 
When describing the function saveas() | only gave 6 of 
its 7 parameters. The statement should have read: 


saveas | Oxfff, save_name, save_len, \ 
save_proc,0,0,0); 
The full program published on the magazine disc was 
correct. 


Creating Draw Files from Basic 


Italic Paladin 


Paladin 
Systen Font 


This example program (described in the magazine) 
uses the CDraw library of procedures to produce a 
Draw file consisting of a number of text objects ina 
variety of fonts and styles. 


Using CLib from Assembler 
[Wun adfst:Wardbiso.8 MUdises. 905, (Lib. Files txanple 
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This utility demonstrates the use of the Shared C 
Library from within assembly language programs. 
It takes lines of text and prints them with the first 
letter of each word capitalised, and all other 
letters in lower case. Also included is a list of all 
the calls provided by the kernel and C library 
parts of CLib to help you use CLib from your own 


programs. 


Exploiting the Wimp (Part 5) 


To Epporctrom Wimnbons: 
EPP OR FROM WIAD! 


File transferred; This is 
sone text that has 
beentransferred by RAK! 


The example application given this month 
implements the loading, of data via RAM transfer. 
If a file is saved via RAM to the icon bar icon (e.g. 
by saving directly from Edit onto the icon rather 
than from a disc) then the application displays the 
first 100 characters of the file in an error box. 


RISC User Disc Contents 


Improved Half Tone Printing 


Included on the 
disc are two 
sprites, a Draw 
file and a Palette 
file to help 
demonstrate this 
method for 
improving the 
rint quality of 

If tone sprites 
on dot matrix 
printers. The two 
sprites are “before 
and after” 
applying the 
methods, using 
the grey scale in 
the Draw file. The Palette file contains the 
improved grey scale as described in the article, 
and could be useful in improving your own 


graphics printouts With minimal effort. 


Character Rulers Application 
A very handy utility 
that will help m Text can be measure 
prevent distress Mm easily using thi 
caused by having to “uler ane heaton 

his is the fourth line 


count lots of text 
characters. These 
tulers allow the 
lengths of lines in 
text editors to be 
counted easily, as 
well the number of lines in a vertical direction. 


and this arrow is in the 
16th column: 


| (EEL “Winchester > Flopps 


ADDITIONAL ITEMS REFERRED 
TO IN THE MAGAZINE 


Giant File Backup 


This application 
permits the 
backup of large 
hard disc files 
onto floppies. 
This can be very | 
handy if you 
create files (in 
databases for 
example) that 
are longer than 800K but you don’t want to have 
to wait for file compression or for the whole hard 
disc to be backed up. 


All of these powerful applications and 
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Killer and VProtect - Virus Protection 


This application (=== rr RE 


and module, 

supplied under | 

licence from A WARNING: MRulers is infected 
Acorn, 

represent the 
most 
comprehensive 
anti-virus kit 
available at 


| with the Extend vires. 


Ce] 


present, enabling you not only to rid your machine 
of any Known viruses, but also to have continual 
protection in case anything nasty tries to attack 
your precious data. The Killer application is being 
taken over as a commercial product by Pineapple 
Software, so this looks like becoming the definitive 
virus kit for the Archimedes. 


The game 
“Breakout” has 
appeared in 
many guises on 


but not many 
variants are 
played witha 
mouse, and not 
many have the 
additional 
feature of being 
able to alter the angle of the bat. Buster is a mouse 
controlled version of “Breakout” that goes beyond 
the usual lateral movement of the bat, producing a 
game that is both challenging yet simple in concept. 


Mode Aid - A Desktop Mode Utility 


An updated version (version 1.42) of the application 
from the Volume 5 Issue 3 disc which allows 

comprehensive Desktop mode management, and gives 
information on any mode your machine will support. 


selection of bonus items for only £4.75 


many computers, 
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WRisclser Buster  !CDraw 


t 
'DrawRuler !GiantFile 


—) 
ao 
'OnePath 


tHalfTone 


8 
Rulers 


Five Draw files 
created with 
RISC 
Developments’ 
text manipulation 
package 
TypeStudio. 


X Eigen Factor: I 


Mode 29 OS; 1152 Rag 


OS Units: 1596 


This useful application takes a Draw file consisting 
of disjoint Draw paths and joins them up. This can 
be very useful as only single paths can be filled, 
and some programs (like DrawBender) require 
single path objects for their own purposes. It is also 
possible to create shapes that are impossible to 
create with Draw using this application. 


Draw Ruler | 
A Draw file which 
contains two rulers, 
graduated in inches, | 
which can be used | 


to measure objects 
in Draw files. 


ArcScan Data 
ArcScan indexes for this issue of RISC User and 
BEEBUG Vol.10 No.9. 


Into the Arc: 


Shared Resources (Part 2) 
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by Mike Williams 


L ast month I discussed the use of !System 
and !Scrap, two resources on your 
Archimedes whose functions can be shared 
by any applications which you choose to 
use. This month, I want to deal with two 
other resources which, though different, can 
also be considered as shared by other 
applications. These are outline fonts and 
printer drivers. A5000 users should note 
that my comments on outline fonts apply 
very largely to them as well, but the use of 
printer drivers has been heavily revised in 
RISC OS 3 and although any general ideas 
may still be valid, the subject of printer 
drivers on the A5000 really needs an article 
to itself. 


OUTLINE FONTS 

As Iam sure you are aware, outline fonts 
are defined in terms of mathematical curves, 
together with some additional information 
(referred to as hinting and scaffolding) 
which ensure that as far as possible all 
characters are equally well drawn at both 
small and large sizes. Outline fonts allow 
the outline of any character to be accurately 
and smoothly scaled to the required size 
before the outline is filled to complete the 
character. Once the character has been 
created (and presumably displayed on 
screen) it exists as a matrix of pixels (a bit- 
mapped character). This process (and 
others) is performed by the Font Manager 
which is supplied under licence from Acorn 
with applications which use outline fonts 
(word processors and DTP packages, for 
example). Incidentally, if you don’t yet have 
a copy of the Font Manager, one of the 
cheapest ways of obtaining a copy is to buy 
the Ovation demo disc (£5 inclusive of VAT 
and p&p) from RISC Developments. 


When outline fonts are in use, an area of 
memory needs to be allocated as a font cache. 
The first time your software attempts to 
display a character at a particular size, the 
Font Manager reads the outline font 
definition, scales this to the required size 


and stores the resulting bit-mapped 
character in the font cache. To make the 
process more efficient, the Font Manager 
scales a block of characters at the same time. 
From then on, displaying the same 
characters at the same size requires only that 
further copies be obtained of the characters 
already in the font cache. This is why there 
are often significant pauses when a 
document is first loaded, compared with 
later use. Similarly, further pauses occur if 
you want to use a different size of character 
or a different font, as the Font Manager has 
to go back to the original outline font 
definitions and recalculate the character. 


The font cache, whose size is under user 
control (see later), poses a potential conflict 
of interest. Clearly as work proceeds, the 
font cache is filled up. When that happens, 
earlier bit-mapped characters are 
overwritten by later ones. The smaller the 
font cache, the worse this problem rapidly 
becomes. If you increase the size of the font 
cache, you reduce the amount of memory 
available for your applications and the tasks 
(documents) you are working on. Let’s now 
look at how things might best be arranged 
depending upon the system you are using. 


MANAGING OUTLINE FONTS 

Users with hard discs and at least 2 Mb 
of memory have fewest problems. The Font 
Manager and your outline fonts will all be 
stored within a single application, !Fonts, 
and this should be installed in the root 
directory of your hard disc. This ensures 
that RISC OS ‘knows’ where the outline font 
definitions are located once the root 
directory has been opened. Alternatively an 
appropriate line can be included in your 
boot sequence (see RISC User Volume 4 
Issues 4 & 5, and the article Automating the 
Desktop in this issue). 


If you open the !Fonts directory (double- 
click while holding down Shift), you will be 
able to see the fonts installed on your 
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system. If you purchase additional fonts 
then they should also be stored within the 
!Fonts directory. The two modules called 
Fonts and Super form the Font Manager 
itself. If you acquire a large number of 
outline fonts, any font menus in applications 
may become excessively long. You can 
overcome this by dividing your fonts up 
into groups. Put all your commonly used 
fonts together with the Font Manager as 
!Fonts. Then create further font directories 
with copies of the Font Manager and other 
less used fonts. 


On the A5000 the Font Manager (and three 
fonts, Corpus, Hommerton, Trinity) is 
contained in the RISC OS 3 ROMs ready for 
use as soon as you switch the system on. A 


!Fonts directory (without the Font Manager) is 
located in the root directory of the hard disc 
(with Porterhouse and System fonts). Any 
additional fonts should also be included here. 


For example, I have four font directories, 
one called !Fonts which contains all the 
standard fonts we use at work, one called 
!FontsA which contains just Acorn fonts, 
'FontsB with Beebug fonts, and !FontsO 
containing other fonts. For this to work 
properly you will also need to change the 
names of the sprites in the !Sprites file to 
reflect correctly the name of the 
corresponding fonts directory. At any time, 
double-clicking on an alternative font 
directory will make those fonts the current 
set. Note that any application which uses 
outline fonts will have to be re-installed or it 
will continue to think that the previous font 
set is still in use. 


This strategy of dividing fonts up into 
groups also works well on floppy-only 
systems, as you may well find that you 
cannot get all your outline fonts on a single 
floppy disc anyway. I believe that this 
approach also has typographic benefits. 
Using a large number of different fonts and 
styles in a document will usually result in a 
worse appearance than the choice of two or 
three carefully chosen and balanced fonts. 


On a floppy disc system, you will 
normally need to keep your selected fonts 
disc in a drive while you are working. If 
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you have dual disc drives then you can 
keep your work disc in the other drive; 
otherwise you will inevitably be involved in 
a degree of disc swapping. Good 
management with the use of !Scrap and 
{System will help to reduce this. I also 
recommend that when you have finished 
with a particular disc, you positively 
Dismount it (click the Menu button over the 
drive icon). This will avoid RISC OS asking 
you to insert a long forgotten disc so that it 
can refresh its knowledge of the disc’s 
contents. 


The question of an appropriate size for 
the font cache is also important. A default 
cache size can be set with the Configure 
command. Exit from the Desktop with F12, 
and enter: 

Configure fontsize nK 
where n is the cache size you want in 
kilobytes. Press Return a second time, and 
then press Ctrl-Break to set this as the 
normal default (obviously making sure you 
don’t destroy any important work in the 
process). On my home-based 1 Mb floppy 
system I have the font cache set to 64K, 
which I find a satisfactory compromise. On 
my work system, with hard disc and 2 Mb 
of memory, I have a default font cache of 
192K. On a 4 Mb machine (or larger) I 
would recommend 256K as a suitable size, 
but your processing needs will determine 
what is the best choice for you (there is a 
maximum of 1024K under RISC OS 2). 


However, if you are using a greater 
variety of fonts than normal, a larger font 
cache may prove useful (if you have enough 
memory). Temporary changes to cache size 
can be made using the Task Manager. Select 
Task display and drag the allocation for font 
cache to a suitable size. Font cache can 
continue to be changed in this way, but 
experience is likely to guide you in what is 
best. 


PRINTER DRIVERS 

The other resource that you are likely to 
need on your system is a printer driver. As 
you will know, most applications do not 
handle printing directly, but rely on the 
presence of a printer driver selected and 
configured appropriately for your printer. 
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Imagine a flexible word processor in 


which you can use fonts and pictures to 
give stunning presentation to your 
letters and reports. And a 93,000 word 
spelling checker and user dictionaries 
for letter-perfect writing. 

Imagine the most powerful spread- 
sheet package on the Archimedes. 
Background recalculation so you carry 
on working while it computes. 160 
built-in functions, plus a programming 
language for your own custom func- 
tions, Arrays within slots for easy 
manipulation of structured data. 

Imagine dynamic charts straight from 
your data. Multiple scales to compare 
trends, Personalised Penguin Graphics 
with bars filled by your own draw files to 


dazzle your friends and colleagues. 


COLTON software 


—S es 


Coltonsoft Limited 
2 Signet Court 
Swanns Road 
Cambridge 

CBS 8LA 

Tel: (0223) 311881 
Fax: (0223) 312010 


PIPEDREAM 


Imagine a fast and compact database 
package with full sorting, searching and 
selection criteria. With links straight to 
the word processor for printing mail- 
shots and labels. 

Imagine user-friendly fearures such as 
configurable menus, template files to 
start new documents from, and auto- 
matic fitting of column widths to the 
data. 


PipeDream 4 
the works 


Free your imagination. 


RRP £196" VAT. Call for education pnees 
and site licences. PipeDream 4 is ideal for any 
Archimedes, A3000 or A5000 with 2MB 
RAM or more. 


For a free © brochure. complete and 
return this coupon, 


Name ———_ 


Address 


Posteode 


would Dhe to thank you am your 
Ove fo Our HOW preinisen AS ¢ 
and of schedule and the disrupt 
oan absolute minimunr ff ont 


VIP PLANE ‘sales - 
obviously good | 
Xmas presents! 


eke Bs S58 x 
¢ Gide Gidy Munro von Chap a, 
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Using printers and printer drivers can 
cause a lot of problems despite this 
supposedly simple system. It is not my 
intention to delve particularly deeply into 
this here, as the subject has been covered in 
several previous issues of RISC User 
(Volume 3 Issue 9, Volume 4 Issue 3, Volume 
4 Issue 8), and our 80 Column series also 
deals with this subject. Instead I want to 
offer some general advice for those who as 
far as possible would like to avoid any 
complexities. 


I strongly recommend that when you 
buy a printer, you get the dealer to tell 
(show) you which printer driver you will 
need to use, and which configuration. There 
are three common ones: PrinterDM for dot 
matrix printers, PrinterL] for Hewlett 
Packard Laserjet type printers, and 
PrinterPS for PostScript printers. 


If you install a printer driver on the icon 
bar and click with the Select button over its 
icon, a window will open showing various 
user definable settings. At the top of the 
window will be displayed the name and 
model number of a particular printer. 
Clicking further with Select or Adjust on 
this name will enable you to cycle through a 
whole range of similar printers. Obviously 
you need to know which one to select for 
your printer. Within the main window there 
are other settings which may need to be 
changed. For example, if you are using 
continuous computer stationery, or have an 
auto sheet feeder, then the auto feed option 
needs to be selected; if you are using single 
sheets manually loaded you will need to 
select the manual option. Again, get your 
dealer to show you the settings appropriate 
to your printer, or at least explain why you 
might want to change some of these. 


If you now close this window and press 
the Menu button over the printer driver icon 
on the icon bar, you will see an option Save 
choices. Click on this to ensure that your 
choice of printer model and other settings 
become the default. Once this has been 
done, then each time you load the printer 
driver it will be ready for use, but do 
remember that some settings you may want 
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to change from time to time. For example, it 
is probably sensible to have draft as the 
default mode, and only change 
(temporarily) to NLQ for the final copy. 


You will also find that the menu has an 
option called Page size. The parameters in 
this window define the print area 
(separately for text and graphics). Many 
printers cannot physically print over the full 
area of the paper. The parameters in the Page 
size window can be set to ensure that the 
printable area recognised by the printer 
driver coincides with the printer’s physical 
print area. Generally, however, you should 
have little need to change the parameters 
which you see here. 


Apart from the printer drivers supplied 
with the Archimedes (which cover most 
printers), some newer or more specialist 
printers require that you buy a purpose 
built printer driver. This is true for the 
Hewlett Packard 500C colour printer 
reviewed in this issue. Printer drivers for 
this are available from Ace Computing and 
RISC Developments for about £15 in each 
case. Again, seek advice from your dealer. 
Indeed, it may be worth paying a little more 
than the lowest possible price for which you 
might see a printer advertised just to ensure 
that you get adequate advice from a 
competent Acorn dealer or supplier, as I 
have outlined above. 


As far as practicalities are concerned, 
hard disc users are probably best advised 
to create a directory called PDrivers (or 
similar) in the root directory, and store 
there any printer drivers which may be 
needed. For floppy disc users, you have, in 
principle, two choices. Put any printer 
drivers you need on your system disc 
(along with !System); use this disc when 
you first switch your system on, and install 
the printer driver ready for future use. If 
you use a boot sequence, then installing the 
printer driver can be included as part of 
that sequence. However, there is no penalty 
(other than duplicating disc storage) in 
keeping copies of your printer driver on all 
the discs from which you might want to 
print. A 
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Alan Wrigley describes how to use linked frames for automated formatting of 


data imported as 2 text file. 


or some years | have produced invoices by 

manually entering the data into a program 
which then sent the output to the printer as a text 
file. Recently | have started using Ovation for all 
my correspondence, and | investigated the 
possibility of also using it to produce attractive 
invoices automatically from data imported from 
an accounts package. The method | chose is to 
create a series of linked frames, each of which 
holds a specific element of the data. These frames 
can be positioned anywhere on the page and can 
be linked in any order. 


Magnificent Widgets Ltd 
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Figure 1. Template showing linked frames 


The method is suitable for many other 
purposes where data in an acceptable form 
can be imported from a database or other 
application. So you can use Ovation to design 
your own reports, neatly laid out and with 
your own heading, and simply drag in an 
unformatted text file containing the necessary 
data. The text will flow from one frame to the 
next, and if you have designed your page 
correctly all the information will appear in the 
right place. 


Although Ovation is used as the example 
here, any other DTP package which can 
handle linked frames in the same way would 
be equally suitable. The data is best in the 
form of a plain ASCII text file, but a CSV file 
could be used if you are willing to spend a 
minute or two with Edit to convert the comma 
separators into linefeeds. | will look more 
closely at the production of the data file later. 


USING LINKED FRAMES 

Linked frames enable you to flow a piece 
of text across from one frame to another. If 
you are using only the principal text frames, 
this happens automatically, with Ovation 
generating a new page as the text flows over 
the end of the previous one. However, for 
producing reports as described here, you must 
create separate text frames and link them 
explicitly using the link tool. You can link a 
number of frames in a chain, and the text will 
then flow across all these in turn. This is the 
feature which enables us to produce our 
reports. Once the basic layout has been 
designed it can be filed away and used over 
and over again. 


LAYOUT 

First of all, you must have an idea of the 
data which will be imported, and where on 
the page you want this to appear. Using the 
invoice example, your data file would 
probably contain the date, invoice number, 
order number, addressee, a list of items 
together with their price and VAT rate, a sub- 
total, a VAT total, and a grand total. Figure 1 
shows a typical example of how this might be 
laid out, with the frame links clearly shown. 
The heading and the other text shown on the 
page are all included at the design stage, so 
that this can be used as a template for all 
subsequent invoices. 


THE DATA FILE 

Any text file can be imported into the first 
frame in the chain, and the text will then flow 
across the subsequent frames. Obviously the 
design of the invoice and the nature of the 
data available go hand-in-hand - it is not 
much use if half the customer’s address turns 
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up in the frame chosen for the invoice 
number. So first of all, you must make sure 
you know the format of the data you will be 
receiving. Different applications may output 
data in different ways, but what you are 
likely to get is a file containing a list of data 
items separated by linefeeds. 


There are two ways of ensuring that the 
data fills only the space intended and does not 
overflow into another frame. Firstly, you can 
design the frames so that each can contain 
only the exact number of lines required. For 
example, an address may require 5 lines of 
text, while the date and invoice number need 
only one each. Designing the frames with this 
in mind will ensure that the text will 
automatically flow into the next frame when 
the space is 
used up. To 
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sotyou would need to create further frames 
for the price, VAT rate and VAT amount data. 


UNWANTED DATA 


It may be that some of the data output in 
the text file is not required in the report. For 
example, you may be producing an estimate 
for a customer based on information in a 
database. The database may contain 
information such as materials, price and so on, 
which you need to show on your estimate, but 
also stock codes, which you do not. To get 
around this without having to edit the text 
file, simply create a frame somewhere where it 
will not be seen (on another page, say), and 
link it into the chain at the correct place. 


CREATING THE FINAL RESULT 
All the hard work has only to be done 


once, and from then on producing an invoice 
or report can be done in seconds. Once the 
template is complete, simply position the 
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Invoice No; 210192 Tax Point 12 Feb 1992 


ALI 41S be sure that 


the data 
file always 
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number of 
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each item, 
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Figure 2. Example invoice produced as 


address is 
only 4 lines 

aescsiest long, there 
must be a blank line at the end. In most cases 
this will be true, since databases etc. usually 
work ona fixed number of fields for an address. 


A much better way of ensuring correct 
placement of all the data is to put a formfeed 
character (ASCII 12) at the end of each item. 
This forces text into the next frame (and is 
equivalent to pressing Enter when entering text 
manually in Ovation). However, databases do 
not often output text files with formfeed 
separators, though if you are using software 
you have written yourself you will be able to 
make use of it, and if not you can always use 
Edit to insert formfeeds in the right places, as 
described later. 


In the example shown here | have created 
a single frame in the centre of the page for the 
invoice items, because I have arranged for my 
accounting software to output each item as a 
single line of text with tabs separating the 
description from the price and so on. Other 
software might well output the description 
and the price as separate data items, and 
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caret in the first frame of the chain and drag 
in the text file. If you have got your design 
right, all the data should appear in the 
correct place. Figure 2 shows part of the 
example invoice with data in place, 


When you link frames together in Ovation, 
frames lower down the chain take their style 
and format information from the first frame in 
the chain. Unfortunately this means that you 
cannot pre-design different formats and styles 
for different items of data. So if your first 
frame is left-justified, Homerton, 12 point, 
with tabs set at 20, 40 and 80, then so will all 
the other frames. However, once the text has 
been imported you can apply local styles to 
any part of the document, so it is possible at 
this stage to introduce different fonts, tabs etc. 
to any data item. 


MODIFYING THE DATA FILE WITH EDIT 


It is possible to use the global 
search/replace facility within Edit in order to 
tinker with data files that do not quite meet 
the required criteria. For example, if you are 
designing a report in which each frame will 
contain one data item, and your database 
produces a text file in which each item is 
separated by a linefeed, then you could load 
this file into Edit, replace all occurrences of 
the linefeed character (ASCII 10) witha 
formfeed (ASCII 12), and save it directly into 
your Ovation document. You could do the 
same with a CSV file, this time replacing all 
commas with formfeeds. BYU 
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Base Base5 DBMS v2.00 


BaseS DBMS is a suite of BASIC V functions and procedures designed 
to implement database programs. Now upgraded to v2.00, it remains 
fully compatible with RiscBASIC and ABC compilers. 


@ Fully compatible with RISC OS, with Wimp Interface support 

@ User configurable 

@ Extensive search features 

® Multiple databases in use simultaneously with easy communication between them 

@ Rigorous in-built error checking and Command History 

® Comprehensive documentation of tutorial material, language reference and file format 
@ Extensive import and export features 

@ A separate library of mathematical and calendar functions 

@ A fully multi-tasking database application !BaseS5 as a get-you-started entry point 

® Flexible and easy to use Report Designer/Generator 


PairData 


First of an increasing number of fully compatible products for use with BaseS DBMS. 
@ A BASIC V library for the creation and processing of coordinate pair data 
@ !Mouseln, a fully multi-tasking utility to write pointer coordinates directly into databases 
® Centre of Gravity, mean distances, nearest and furthest point calculations ete. 


AdMaths *** NEW *** 


A library of advanced mathematical and statistical routines fully compatible with all existing 
BaseS products. 

@ Skewness, Pearsonian and Kurtosis indexes 

@ Median, Mode, Quartiles and Trimeans, Geometric, Harmonic and Quadratic means 

@ 3 non-linear Least Squares best fit 

@ Harmonic curve fit by Fourier analysis 

@ Student ¢ and Chi Squared tests 

@ Fully programmable graphics routines for Pie, Bar, Line, Scatter, etc, diagrams 

@ Export of graphs as Sprites or Draw files for easy inclusion in DTP 

@ Separate library for any BASIC program to export graphically as Sprites or Draw files 


Base5 Base5 DBMS = £69.00 

P.O. Box 378 Demo Disc £5.00 refundable on purchase of full system 
WOKING PairData £22.50 (£18.00 to Registered Users) 
Surrey GU21 4DF AdMaths £25.00 (£20.00 to Registered Users) 


Great Britain No VAT 


Killer and VProtect - 


by Acorn Computers 


iruses are fast becoming a pest, and this has 

been reflected in the amount of coverage RISC 
User has devoted to virus protection software. The 
Killer application and VProtect module from Acorm 
Computers represent the most comprehensive virus 
detection package yet released, and will not only 
scan discs for known viruses, but will also help 
protect your system from infection. 


VProtect is a module that will prevent any of 
the known viruses from infecting your machine. It 
should ideally be loaded by a Boot sequence on 
power up, and will keep a clean machine clean by 
checking every !Boot file that is executed (this is 
where viruses normally live and spread). It also 
prevents the Module virus from spreading to all 
the modules in your machine. The following 
viruses are protected against: 

Extend 

Icon (also known as Filer), and known variants 

FF8 (also known as Archievirus) 

_ RISCOSext (also known as Thanatos) 

DataDOM (also known as Vigayvirus) 

CeBit 

MyMod (also known as Silicon Herpes) 

TrapHandler/NetManager 

Module (also known as ModVir) 

Image 
VProtect consumes very little memory and is a very 
effective way of protecting your computer from 
infection. 


Killer is a much more comprehensive multi- 
tasking application that will scan any disc for the 
above viruses, and will disable (and attempt to 
remove) any that are discovered. It can produce 
Log files of any scan, detailing files that Killer is 


Virus Protection 


suspicious of so that unknown viruses may still be 
detected. The application can also be set up to be 
on the alert constantly for viral infection, so a virus 
alert will be reported the instant a virus is 
contracted, thus allowing the infected disc to be 
pinpointed and the source to be traced. This 
application is being taken over as a commercial 
product by Pineapple software, and the version 
supplied here will only work on machines whose 
CMOS clock is before 30th June 1992. 


Extend virus loaded 
adfs::8.$.'!Rulers 'Boot 5 


7 ae 


Killer catches the Extend virus 


These two packages will enable you to keep 
your machine infection-free, and will help you to 
detect anything suspicious on any of your discs. 


AU 


Both the applications on this page are supplied 
only on this month's magazine 


An Application to Back Up Very Large Files 


by Kell Gatherer 


t can happen, by accident or design, that a file 

held on a hard disc is larger than can fit onto a 
floppy disc. PipeDream and Impression, for 
example, can both create files up to the size of the 
RAM available, and the MultiStore database can 
handle up to a staggering 2.17tbillion records! The 
largest file possible on a newly formatted E-format 
disc is 815,104 bytes, while a hard drive can in 
theory hold one file up to its entire capacity: 20 
megabytes or more. Backing up such a file clearly 
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presents a problem, which the GiantFile application 
solves by enabling a single file to be backed up 
onto two or more floppies. 
Using the application is simplicity itself. To put 
a file onto hard disc you simply drag that file onto 
the icon bar icon, and the application deals with the 
rest, prompting for new discs as and when 
required. Restoring files is just as easy, and files can 
be saved anywhere on your hard disc, with any 
fil ‘ou wish. 
letype y' AY 
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Colour Printing 


with the Deskjet 500C 


David Spencer looks at what is being heralded as a revolution in low-cost 


colour printing. 


hile the Archimedes provides a 

spectacular combination of on-screen 
graphics and advanced software, what use is 
it if the results cannot be printed out? Over 
the past few years the price of black and 
white printers has dropped considerably, and 
more sophisticated options such as laser 
printers have become a reality for many 
users. However, full colour printing has 
always proved a major stumbling block. 


That was until the Hewlett Packard 
DeskJet 500C entered the scene. This printer 
is capable of producing vivid full colour 
prints at resolutions of up to 300 dots per 
inch. To give you an idea of what that 
means, a picture scanned with a colour 
scanner and then printed could be mistaken 
for an original when viewed from a 
reasonable distance. In addition, the DeskJet 
500C can be equipped with a black print 
cartridge that turns it into a laser printer 
quality text printer, with the same 
specification as the standard monochrome 
DeskJet 500 that has been around for a 
couple of years. A wide range of built-in 
fonts and styles are provided for text only 
printing. 


The DeskJet 500C, like the HP PaintJet 
which came before it, is an inkjet-type 
printer, which is much better suited to 
colour work than an impact printer using a 
ribbon. Inkjet printers work by using 
essentially liquid ink, and spraying it onto 
the paper. This is usually done by using a 
small heating element to burst a bubble of 
ink onto the paper. The use of liquid ink as 
opposed to an impregnated ribbon allows 
much stronger inks, giving higher contrast. 


The DeskJet 500C incorporates the ink 
and all the printing mechanism into a 
disposable cartridge which just pushes in 


and pulls out. In fact, two cartridges are 
provided, one containing just black ink, 
and the other the three colours, cyan, 
magenta and yellow needed for colour 
printing. Only one cartridge can be fitted at 
a time, and Hewlett Packard very 
thoughtfully provide a storage box for the 
cartridge not in use. The cartridge life 
depends on what is being printed, but a. 
typical figure would be about 400 pages a 
cartridge for text printing. 


When unpacking the DeskJet 500C you 
could be excused for thinking that you have 
the wrong product, as it appears almost 
identical to the monochrome DeskJet 500. 
The DeskJet is a very specific square shape, 
with a paper tray at the front and a 
collection tray above it. A flip-up lid covers 
the printing mechanism, and there is a 
smoked plastic cover over the collection 
tray. The overall colour of the printer is a 
cream tint not dissimilar to the Archimedes 
itself, with a grey base. The novel shape 
makes the DeskJet an ideal printer for use 
ona shallow desk. 


The DeskJet 500C will print on paper or 
transparency film (for overhead projectors), 
but in either case can only cope with single 
sheets and not rolls or fan-fold paper. The 
paper tray will accept about fifty sheets at a 
time, and there is separate provision for 
feeding envelopes. Sheets of paper are fed 
from the tray and wrapped through 180 
degrees to come out the other way up in the 
collection tray. The printing is achieved one 
line at a time as the paper passes into the 
collection tray - meaning that the output is 
print-side up. The very tight paper path 
means that there are serious restrictions on 
the weight of the paper. You can forget 
about trying to print on card, and we found 
problems with standard laser printer labels, 
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which tended to peel off. The maximum 
paper size is US Legal, which at 215 by 
355mm is a little larger than A4. The width 
of the paper in the paper tray can be 
adjusted by a lever, and a moveable endstop 
controls the length. One problem found 
during testing was that if there was only a 
single sheet of paper in the tray, it invariably 
fed in slightly skewed. This can be avoided 
by keeping several sheets in the paper tray 
at all times. 


Overall print quality also depends on 
the type of stationery being used. For 
monochrome printing, normal photocopier 
paper is perfectly adequate, while colour 
printing gives best results on Hewlett 
Packard’s special paper which is coated 
with a thin layer of chalk on one side. This 
gives brighter colours and a crisper image. 


To the right of the printing area is a 
control panel which has the usual buttons 
found on a printer for putting it on and off 
line, resetting, and paper feeding. Buttons 
are also provided for moving the print 
head to a position where it can be changed, 
and cleaning the print head. This cleaning 
operation will unblock the nozzles in the 
print-head and print a test page. Adjacent 
to the control panel are two cartridge slots 
which allow extra fonts to be added, and 
also printer emulation cartridges. For 
example, a plug-in emulation for standard 
Epson printers is available. 


Printing speed depends entirely on what 
you are doing. Printing plain text in 
monochrome will churn out a page in less 
than thirty seconds, while a full colour 
graphics dump (such as produced by the 
Archimedes) can take over ten minutes to 
print. This is partly because the printing 
speed has to be reduced to let each colour 
dry before printing the next, and partly 
because of the sheer amount of data being 
sent to the printer. 


DOCUMENTATION 
There is no shortage of paperwork 
supplied with the DeskJet 500C. As well as 
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Colour Printing with the Deskjet 500C 


the main user guide, there is an installation 
guide, a software guide and a very useful 
booklet on using colour to advantage in 
document design. Software drivers are also 
supplied, but these are only applicable to PC 
compatibles, with drivers for Windows 3 
and many common DOS applications. 


One thing lacking from the manuals is a 
detailed description of how the printer is 
controlled using its PCL language (see 
below), though a list of commands is given. 
Instead, a separate technical manual is 
available. 


Deskjet 500C colour printer 


DRIVING THE DESKJET 500C 


As with all other types of printer, a 
printer driver program is needed to allow 
RISC OS applications to print their output. 
The DeskJet 500C is controlled by a series of 
commands affecting aspects such as 
resolution and colour. These commands are 
called HP PCL level 3 command set (Printer 
Control Language), and are a superset of the 
commands used to control the monochrome 
DeskJet and LaserJet printers. This means 
that for monochrome printing, the Acorn’s 
standard PrinterL] driver can be used, 
although multi-copy printing cannot be 
performed, as the driver is designed for a 
laser printer and not an inkjet. However, a 
special driver is needed for generating 
colour output. 


So far, two companies have produced 
such drivers - Ace, who are well known in 
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the printer driver field, and ourselves, RISC 
Developments. The RISC Developments 
driver supports both colour and 
monochrome printing, with resolutions of 
75, 150 and 300 dpi. It is a ‘release 2’ printer 
driver meaning that it supports commands 
to allow plain text files to include highlights 
such as italics. Having not seen the Ace 
driver, I cannot comment on it, but I would 
expect it to be very similar. Both drivers are 
priced at £15 ex VAT. Further problems arise 
when using the printer with an A5000. This 
is because printer drivers for RISC OS 3 are 
different. To overcome this, both companies 
are working on RISC OS 3 versions of the 
DeskJet driver as well. 


CONCLUSION 

Before I first saw the DeskJet 500C I had 
heard many comments about it - and every 
one of them saying how brilliant a printer it 
is. Having played with it at considerable 
length, I can only agree. My only quibble is 
that unlike some printers, black ink is not 
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available during colour printing. This means 
that black has to be made by mixing the 
three colours. This gives good results on 
small areas, but gives a muddy-green on 
large areas. 


It is a shame that we have no way of 
reproducing a sample output here, as I'm 
sure you would agree with my conclusion. 
All I can say is that if you have been 
thinking about a colour printer, albeit just 
in passing, then go and buy a DeskJet 
500C. Even if you are considering a 
monochrome printer, still look at the 
DeskJet 500C - with its monochrome mode, 
it is jack-of-all trades and a master of them 
as well! 


The DeskJet 500C is available from most 
computer dealers, with an average price of 
around £600 ex VAT. The cartridges cost £14 
for the black only one, and £25 for the 
colour cartridge. The special JetSeries coated 
paper is about £20 for 200 sheets. AU 


Ra ks Tt * 
ADVANCED STATISTICAL SYSTEM 


Is the ESTABLISHED Statistics Package for the Acorn Archimedes 


It is widely used in Research, Physical and Life Sciences, Medicine, Industry, Business and 
Education 


‘FIRSTJR’ is designed to appeal particularly to the Education Sector 


Providing an impressive selection of statistical techniques it includes FIRST's powerful 
data handling, interfacing and display facilities and on-line manual 


"FIRST JR" 


FIRST JR offers a remarkable performance/price ratio at its cost of £55 
Previous ads. in RU contain some details on FIRST 


For full technical and pricing information on the latest version of FIRST and FIRST JR 
contact: 


Serious Statistical Software, Lynwood, Benty Heath Lane, 
Willaston, South Wirral L64 1SD. 
Tel. 051 327 4268. 


is now available 


Our new product 
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Assembler Workshop ——— 


Using CLib 


Want to relieve the hard slog of ARM code programming? David Spencer 


shows how. 


ne of the most tedious, time-consuming 

and sometimes hardest bits of ARM 
code programming is the writing of routines 
for formatted output, arithmetic, file 
handling, memory allocation etc. However, 
every Archimedes owner already has a set of 
standard routines to perform these functions 
and more, in the form of the Shared C Library 
module. The real purpose of this module is to 
implement all the functions specified by the 
ANSI C specification. The use of a single 
module saves space in a multi-tasking 
environment when compared to the 
alternative of linking the individual routines 
in with each C program. However, we can 
also use the module’s calls in our own ARM 
code programs. 


There are two ways to gain access to the 
shared library (which we will call CLib from 
now on). The first is similar to the way in 
which C itself uses the library. You must 
assemble your code using the Acorn object 
assembler, ObjAsm, and use Link to link in 
the ‘Stubs’ file supplied with the C 
Compiler. This stubs file provides a 
springboard into the CLib routines. This 
method is the most straightforward, as 
‘Stubs’ does most of the work, but it does 
mean you need to spend a small fortune on 
the Assembler and C Compiler. The second 
method is to write your own code to 
interface to CLib directly, and access the 
routines that way. It is this method that we 
shall explore here. Unfortunately, you don’t 
get owt for nowt as they say, and to use the 
CLib routines you must play by its rules. 
This complicates your code somewhat, but 
is worth it when you consider the saving in 
work that can be achieved. 


As the process of calling routines in CLib 
needs to be as quick as possible, the 
standard method of interfacing to a module 
via a set of SWI calls is not used. Instead, 
your program must register itself with CLib 
(using a SWI call) and provide an area of 
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memory to use as a jump table into the CLib 
routines. The initialisation code will set up 
this table for you, and each routine can then 
be called by branching to the appropriate 
offset within the table. Some of the CLib 
routines also require their own workspace 
that must be preserved across calls to the 
routine (static variables in C). As this 
workspace must be unique for each 
program using CLib, the memory area to 
use is specified in the initialisation call. The 
default contents of the workspace are set up 
in a similar way to the jump table. 


To confuse matters further, CLib is split 
into two parts - the language independent 
kernel, and the C library itself. The kernel, 
which provides low level functions such as 
simple arithmetic and interfaces to the 
operating system, can be used without the C 
library, but not vice-versa. For the purpose 
of this article, we will assume that both are 
always used together. The framework for 
interfacing to CLib is then something along 
the lines of: 

1. Use a SWI call to initialise the jump 
table and static workspace. 

2. Call a routine in CLib called 
‘_kernel_init’, passing it a description of the 
higher level C library. 

3. The _kernel_init call doesn’t return 
directly, but instead passes control to an 
initialisation routine, the address of which is 
specified in the description supplied to the 
call. 

4. The initialisation routine should make 
a further call to a routine called 
‘ clib_initialise’ to set up the C library, and 
then return, passing back the address of 
where execution is to continue. 

5. Execution proper will start at the 
returned address, and routines can now be 
called as needed. The program is exited by 
calling SWI “OS_Exit”. 


While the above may seem very 
convoluted, we shall shortly present an 
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example program that will make it all 
clearer. Indeed, you can cannibalise the 
example for use in your own programs. 
However, before that we need to take a look 
at the routines themselves, and how 
parameters are passed to and from them. 


There isn’t space in this article 
unfortunately to detail all the routines. 
Instead, a list of them together with the 
parameters they take is included on this 
month’s magazine disc. A list also appears 
in the RISC OS 3 Programmer’s Reference 
Manual when this becomes available to the 
public later in the year. 


All the routines use the so-called ARM 
Procedure Call Standard (APCS) for passing 
parameters and results. This is an Acorn- 
defined standard that allows routines 
written totally separately to work 
harmoniously together. The APCS is 
described fully in the PRM, but luckily for 
us, most of the complex bits are concerned 
with the callee (i.e. CLib) rather than the 
caller (us). It is, however, vital to get our bit 
right, or everything will fall over. 


Under the APCS, routines are called 
simply using the normal BL instruction 
(with an optional condition of course). The 
routine being called will preserve the 
contents of registers R4-R11, R13 and the 
flags. Floating point registers F4-F7 (as 
provided by the floating point emulator) are 
also preserved. In addition, you must 
preserve R10, R11 and R13 at all times 
during your program. Register R13 in fact 
points to a normal (full descending) stack 
that you can rely on to have 256 bytes free at 
any time. 


Parameters passed to the routines are 
viewed as a sequence of word-sized values. 
For example, the C ‘printf’ function takes as 
the first argument a pointer to the format 
string, and then a variable number of 
additional arguments as specified by the 
format string. The first four arguments are 
passed in registers RO-R3. Any further 
arguments must be pushed onto the stack 
using an instruction such as STMFD 
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R13!,{RO}, assuming that RO contains the 
argument. This pushing must be done in 
reverse order so that the fifth argument is at 
the top of the stack, the sixth immediately 
below it etc. If a routine wishes to return a 
value that can be fitted into a word (for 
example an integer or a pointer) then this is 
returned in register RO. Similarly, a floating 
point result can be returned in register FO. 
For returning any more complex results (a 
whole C struct say), the caller must provide 
an additional first parameter which is a 
pointer to where the result should be stored. 
All this will become clear in the example. 


The above section is deliberately vague 
about how different data types are actually 
represented, as this is defined by the C 
language implementation, and not the 
APCS. Integers, chars and pointers are all 
treated as a single word as would be 
expected. Floating point values are in the 
form of the single or double precision 
provided by the Floating Point Emulator, 
depending on whether they are ‘float’ or 
‘double’. Strings are stored as a series of 
bytes in memory, and are passed as a 
pointer to the first character. Similarly, 
arrays, structures, and unions are stored in 
memory as a series of words, and are passed 
as a pointer to the first word. 


AN EXAMPLE PROGRAM 

So far we have covered a lot of material 
in little space, and it has necessarily been 
rather terse and lacking in detailed 
explanations. The following simple example 
program shows how the C library routines 
can be used to print out a message followed 
by a number. When run, the program 
assembles the code and saves it in a file 
called ‘Example’. This should be executed by 
typing *Example, or double-clicking on it. 


The magazine disc contains a highly 
commented example program that 
illustrates exactly what is being done at each 
stage. The combination of this program 
together with the functions details included 
on the disc, and the PRM’s description of 
the APCS should allow you to write your 
own programs using CLib. 
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10 REM > ExCLib BZ) 5 
20 REM Program CLIB Example 530 .string 
30 REM Version A1.00 540 EQUS "As a test, 10 * 10 = $a" 
40 REM Author Davia Spencer 550 EQUW &DOA 
50 REM RISC User April 1992 560 EQUB 0:ALIGN 
60 REM Program Subjecz to Copyright 570°: 
70 2 580 \ Description of where to store 
80 REM Offsets of routines 599 \ jump table and static variables 
$0 _kernel_init = 0 600 .stubs EQUD 1 
100 _clib_initialise = 20*4 610 EQUD kernel_vectors 
110 printf = 91*4 620 EQUD kernel_vend 
120 Clib_LibInitAPCS_R = £80681 630 EQUD kernel_statics 
130: 640 EQUD kernel_send 
146 DIM code 1000 650 EQUD 2 
150 FOR pass = 0 TO 3 STEP 3 660 EQUD clib_vectors: EQUD clib_vend 
160 O$=code:P%=&8000 670 EQUD clib_statics: EQUD clib_send 
170 [OPT pass+4 680 EQUD -1 
180 .start 630 : 
190 \ Initialise the shared library 700 \ Block conteining info for 
200 ADR RO,stubs 710 \ ckernel_init cail 
210 LDR R1,workspace_addr 720 .kernel_init_block 
220 ADD R2,Ri, #16384 730 EQUD start: EQUD rts: EQUD rts_end 
230 MVN R3, #0 740: 
240 MOV R4,#1 750 \ Description block used to 
250 MVN R5,#0 760 \ register C with kernel 
260 MOV R6,4&80000 770 \ Library with kernel 
780 .rts EQUD rts_end - rts 


270 SWI Clib_LibInitAPCS_R 
280 : 

290 \ Call _kernel_init 

300 MOV R4,R0 

310 ADR RO,kernel_init_block 
320 MOV R3, #0 


790 EOUD C: EQUD 0 

800 EQUD c_name: EQUD c_init: EQUD 0 
810 .c_name EQUS °C": EQUB 0 

820 ALIGN: .rts_end 

830 


a ? went 840 \ Workspace definitions follow. 
{ kern ct k init ‘ 
ne ‘ SEMELVECEAES + RESHELA 850 \ Note the lengths needed for the 
FN ag : ae 860 \ jump tables and the static data. 
i iia tiieenond iad 870 \ 'Workspace' is the area used 
370 \ RISHKIBEIY BE KO iheee 880 \ for our stack etc. 
ee aaa oak See a 890 \ area used for our stack etc. 
380 \ (via address in rts_block) 900 ] 
390 init MOV RO,R13 910 kernel_vectors = P&: P%+=48+4 
400 MOV R1,#0:MOV RZ, #0 320 yacnel aera = De 
ane STMED Ris, (REE) Saige sbtexucces 930 clib_vectors = P$: P$+=183*4 
420 BL clib_vectors + _clib_initialise 940 clib-vend = Pt 
iii og 950 kernel_statics = P$: P&+=k31C 
SEU TRBER SIGs 5 (a) 960 kernel_send = P& 
450: 570 clib_statics = P&: P&+=kB48 
460 \ Execution proper starts here 980 ‘clib send: = P% 
470 .c_run 990 workspace = P&: P&+=16384 
480 ADR RO,string \ Format string 1000 NEXT pass 
4909 MOV R1,#200 \ Number to print 1010 S¥S "OS _File",10, "Example", &FF8,,c 
500 BL clib_vectors = printt ode, code+ (P$-start) 
510 SWI *OS_Exit’ 
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Following glowing reviews in the computer press ... 


.. a new version of Des kEdit (V 1.20) 


iy 
omarka e 
a mm sould prov 


DeskEdit 


is the ultimote all-purpose editor for the 
Archimedes, with special features for 


se with plain text, Basic and C source 

Edit your Basic programs on the 
desktop and test them interactively 
with a single key press 


DeskEdit features 


Three special Find and Replace modes - from Simple to 
Power Search 


Additional Quick-Search mode for rapid retrieval 
Text macros to insert user strings 
code 


Special Undelete buffer for moving text around, in addition 


to Edit-style Undo/Redo 


Dedicated markers and position finders for finding your way 


around large files 


Clipboard, providing an alternative way to move text around 
On screen Help - full documentation in a scrollable window 


Instant file info feature, and current directory setter 


Caret flash controller for DeskEdit and other applications 
Customised user commands to open directories, run other 


applications and launch Obey files 
Numerous keyboard shortcuts 


Fast text printout including style codes for bold, underline, 


italics, page breaks etc 

Special text printing options with headers, footers, page 
numbering and style codes. 

Preview mode 


Statistics option - a brief summary of aspects of the text to be 


printed, including character, word, line and page count 


with even more 
features for text 
editing and word 
processing tasks 
Basic 
source editing 


in both text and source 


has now been released 


and C 


A new single key 
save-and-run feature in Basic mode, permils virtually 
instantaneous testing of programs and applications as you edit 
them. To make Basic editing even easier, an automatic LISTO 1 
is applied when numbered programs are loaded (and the 
spaces are automatically removed on saving). 


The improved procedure and function browser now \cts 
you browse procedure and function definitions in both 
directions (Cul-D takes you to the next definition, while Ctrl- 
Sh-D takes you to the one above etc). 


In text mode, wordwrap control has been improved, while in 
C mode syntax checking has been extended, and a special Search 
option lets you search for function definitions, 


Other new features are: ¢ dynamic date insertion, ¢ Left and 
Right Justify, * bracket matching, « Align Columns and the Char 
Info option (Ctrl-? puts up a box giving the ASCII code of the 
character at the caret in hex and decimal, and any special 
function it may have - e.g. Bold On etc.) 


Language specific features: 


Plain text 
¢ DeskEdit will format word-wrapped text as you type 
Basic 
* Drag a Basic file to the icon, and it will automati-cally be 
detokenised and loaded into DeskEdit ready for editing, 
Press F3 to retokenise and save it after editing. 
Optional line number stripping. 
Auto indent, automatic line number insertion, and 
checking for matched brackets and quotes - as you type 
Special Basic browser: 
Cut R steps through all REM lines 
Cul D steps through all procedure and function definitions 
Cul P steps through all procedure references 
Cul F steps through all function references 
C language 
A simple syntax checker which operates as you type 
Auto indent facility combined with automatic generation 
of opening braces streamlines source code entry. 
C Function browser 
Curl-F steps through function definitions. 


DeskEdit is supplied with a 48 page manual and a function keystrip 
Members’ Price £19.95 inc. VAT. + p&p Stock Code PEDTb 
Existing users may upgrade to V_ 1.20 by sending their original disc 
together with £2.00 and SAE marked DeskEdit Upgrade 1.2. 


RISC Developments tc 


117 Hatfield Road, St Albans, Herts. AL] 4JS 
27 40303 Fox 0727 860263 


C Notebook 


Compiled and Linked by Lee Calcraft 
Cryptic EOF 


Richard Williams 

Since following your ANSI C series, I have used a 
makefile to compile the examples, and compilation 
has always failed with the non-serious error 
‘missing newline before EOF - inserted’. Where am 
I going wrong? 


The answer is that your source file lacks a newline 
character at the end, and the compiler is 
complaining that it has hit the end of the file (EOF) 
without finding the newline character that should 
terminate the final line of your source. It helpfully 
adds that it will insert one for you - but it still fails 
the compilation. | am afraid that the compiler’s 
messages are often somewhat cryptic. The only 
way to find out what is going on is to thumb 
through the error messages section of the manual 
(appendix C in Release 3). 


bbc_vdu IN MODULE STAR COMMANDS 
K.T. Biggs 
If you try to use bbc_vdu() in a module star 
command it will not work. Desktop C gives the 
message: 
bbc_vdu - Referenced in adfs::HardDisc 

-$.user.module.test 

during the link process. 


If you try _kernel_swi(OS_Writel+7) instead, this 
links OK but you get an abort on data transfer 
error when the star command is issued. The 
solution is to use the following: 

_kernel_swi_regs r; 

rex [0] =7; 

_kernel_swi(OS_WriteC, &r,&r}; 
after #including kernel.h and swi.h. 


CDS and DeskEdit 
G.R.Gilmore 
I use the Beebug C Development System, and have 
found a way to integrate it with DeskEdit so as to 
make use of the extra features of the latter. It 
makes use of three DeskEdit User commands by 
inserting the following 3 lines into the User 
commands file (!DeskEdit.Data.Commands): 
Show C Programs=\f adfs::4.$.C. Programs 
Compile C !RunImage=\o adfs::4.5.C. 
Library.C 
Load C System=\s adfs::4.$.C, !CProg 


The first opens the program's directory, the 
second uses an Obey file to compile link and run, 
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while the third loads the C Development 
application. 


The CRun Obey file contains the following: 

Set CSCompileFile !RunImage 

Set C§Source @.c 

Set CSObject @.o 

Set CSList @.list 

Set CSDebug @.debug 

CC <C$CompileFile> 

link <C$CompileFile> -library=SHLib, 

OSLib, SpriteLib, WimpLib 

run <C$CompileFile> 
You could also add to this file some RMEnsures to 
check that all necessary modules are loaded. 


heap_alloc() PROBLEMS 

Graham Jones 

If you try to claim some memory (say 500K) to load 
a large file, and only 400K is available, heap_alloc() 
returns NULL as expected, and you refuse to load 
the file. But there is a side effect. The 400K will 
incorrectly be added to your application’s 
workspace (as shown by the Task Manager) so that 
other applications cannot use it. 


TEMPLATES FOR dbox 

Lee calcraft and David Spencer 

If you are designing a template for a dbox, it is 
natural to start somewhere near the top left-hand 
corner of the template window, and proceed to fill 
the box with icons. But if you then want to add 
icons at the top, or at the far left, it seems at first 
sight that you must move all icons down (or 
across) to make room (first altering their button 
types to make them draggable again). 


But there are two ways around this problem. You 
can avoid it happening in the first place by scrolling 
the initial template so that you are somewhere in 
the middle of the template window work area 
before you create any icons. Then just use the scroll 
bars to adjust the top and left margins when you 
have finished, finally removing them when the job 
is done. If ever you need to add icons at the top or 
at the left-hand side, just reinstate the scroll bars, 
and scroll your window. The other solution - which 
requires no forethought - is to assign negative x or 
positive y values to your work area co-ordinates, 
and again scroll the visible window. 


Please send us your C hints - all published hints will be 
paid for. 
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Reviewed by Ricky Delarre 


A nyone familiar with the mind bending 
contortions involved in calculating (by 
hand) the data for windows in a Wim 
application will understand the relief felt by 
those who encounter a ‘Template Editor’ for 
the first time. Such an editor allows the 
designer to create windows and icons and 
manipulate their size, contents, colour and 
flags, without resorting to pencil, paper, 
calculator and luck. The designed windows 
and icons are stored in a ‘Template file’, 
which is loaded by the target application 
during its initialisation stages. 


The structure of a Wimp application 
tends to be heavily dependent on that of its 
user interface and so, during development, 
programming and window design are very 
closely linked. 


FormEd is Acorn’s template editor, and 
was first implemented under Arthur. On the 
release of RISC OS a new version of FormEd 
was issued. Later, during the development 
of the Desktop Development Environment, 
FormEd was again modestly improved but 
remains a difficult and unpleasant tool to 
use, with many bugs and inelegancies, and 
it has earned a reputation for friendliness 
and tolerance which rivals that of Saddam 
Hussein. 


I have fought long and hard with 
FormEd, and so felt delighted and a little 
nostalgic to learn of WindowEd, an offering 
from Armen Software, which is seen as a 
progression of, and a replacement for 
FormEd. 


The review version of WindowEd (1.13) 
was provided on a single floppy disc, with a 
few utilities thrown in, including a multi- 
tasking magnifier. 


WindowEd installs onto a hard disc with 
no fuss, and is started in the usual way, by 
double-clicking on its application icon 
within a Filer window. 


In line with the current trend, a 
copyright notice is displayed as WindowEd 


loads and installs itself on the icon bar, 
consuming 384K of application memory. 
The style used throughout is similar to X 
Windows (the UNIX system), and very close 
to Computer Concepts’ Impression, so I was 
instantly pleased with the look and feel. I 
must say, though, that I did find the style a 
little over the top at times, particularly when 
scrollable panes, group borders and 
selectable icons all combine in a single, 
rather cluttered window. 


Once a template file is loaded, a filer- 
style display appears, in which an icon is 
displayed for each window in the file. 
Windows may be created, copied, renamed 
and deleted using this ‘filer’, A double-click 
on a filer icon will open the corresponding 
window for editing. An open window may 
be moved about, brought to the front or 
back, and closed under menu control. All 
the characteristics of a window may be 
edited using a single dialogue box. 


Within a window, icons may be created, 
deleted, edited and moved. The editing of 
icons is performed using a similar dialogue 
box to that used for windows. 


I was very pleased with the convenience 
of the editing facilities; the colour choice 
system is particularly neat, and the text 
describing each editable characteristic of a 
window or icon is clear and informative; 
unlike the rather cryptic clues used in 
FormEd. 


Additionally, there is a neat and very 
useful ‘grab’ function whereby nearly any 
window or icon in the Desktop (even those 
from other applications) may be selected 
and then imported into WindowEd. When 
properly driven, this kind of communication 
between applications under the Desktop is a 
hallmark of Acorn’s window system. It 
enables higher productivity, as well as that 
satisfying feeling which comes of never 
having to re-invent the wheel. 


I noticed with some horror that it is 
possible, while resizing an icon, to move one 
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WindowEd - A Template Editor 


edge of the icon past the opposite edge, 
effectively turning the icon inside out. If this 
sorry state of affairs is left unremedied, the 
window manager generally gets quite upset, 
so WindowEd corrects the icon on 
completion of the dragging operation. 


The normal idiot protection is provided; 
the software issues a warning if the user is 
foolish enough to attempt to delete a 
modified file or window. The window 
used to display such warnings is rather 
unpleasant, and the text contained 
within it liable to misinterpretation, but 
the user will soon get used to these 
minor idiosyncrasies. I have noticed 
that the software sometimes fails to 
detect a modification to the template 
file, and can also mistakenly detect 
such a modification, but on the whole 
it is fairly reliable. 


One big drawback of using FormEd 
is that a window being edited is at the 
mercy of the Wimp environment. For 
example, it is quite natural for the user to 
want to remove the title bar of a window 
being designed if it will not be moved when 
in use by the target application. Using 
FormEd, such a window would be 
immovable, both by the target application 
and FormEd itself! These restrictions can 
waste a lot of time, and are generally very 
irritating. 

Armen’s WindowEd gets round most of 
these problems by providing a ‘toolbox’ 
with icons representing each of the 
operations that can be carried out on an 
open window: close, toggle full size, scroll, 
resize, push to back and move. By selecting 
one of these tool icons, the user may then 
perform that operation on any window in 
the Desktop; a window without a title bar 
may thus be moved. 


Another big advantage WindowEd has 
over FormEd is that it is able to cope with 
more than one template file at a time. Users 
with RISC OS 3 will benefit more from this 
facility, as RISC OS 2 limits the number of 
active windows to 64. It is very easy to 
exceed this limit, but WindowEd handles 
this eventuality gracefully. 


The icon bar menu has, amongst other 
things, a ‘Preferences’ option, with which the 
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user may configure the software to suit 
personal taste. One nice feature is ‘Auto Save’ 
which will write any modified template files 
to disc at regular intervals. This feature may 
be enabled and disabled, and the interval 
between saves may be altered. Additionally, 
the user may choose to be prompted before 
the writing is performed. 


con actions} 


| Button tapes [ene Hoon, af all 


E86: <It5] DI | 


Jat ADJUST-clicks use ESG @ 
_SIcon is selected | 
J Icon is shaded (unselectable) 


Editing an icon 


WindowEd is supplied with a 62 page 
manual, which in the main is informative 
and easy to read. The early part of the first 
chapter can be a little puzzling - but 
fortunately it is mainly preamble and can be 
safely ignored; the style settles down as 
things progress. A tutorial is provided, 
which eases the initial few minutes contact 
with the software. The manual would 
benefit from the addition of an index. 


To conclude my ramblings, WindowEd is 
a well thought out and nicely presented tool. 
I like it. The software has an intuitive and 
logical feel, which enables the novice user to 
benefit from its facilities quickly, and with the 
minimum of fuss. It should be borne in mind, 
though, that WindowEd does not do much 
which is new; in the main it does what 
FormEd does, but in a friendlier fashion. I 
recommend the product to anyone engaged 
in the generation of template files. 


Product 
Supplier 


WindowEd 
Armen Software, 
Laxton House, 
Milton Road, 
Oundle, 
h PE8 4AQ. 
Tel. (0832) 273444 
Price £35 inc. VAT and p&p AU 
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180 
Line graphs can plot just points, points joined by lines or lines 
only. Line graphs provide three variants, simple line graphs, 


layered line graphs and cumulative layered line graphs. 
A Sophisticated Multi-Tasking Package 
for the Archimedes 


" 


.. ‘Style Sheet’ file... makes it remarkably easy 
to create the same type of graph again" 


"Chartwell is deceptively simple..." 


"Chartwell scores on simpler controls..." 


"enough effects... at a price which makes it ChartWell has particular strengths when pie charts are 


: ‘ needed, Up to six pies can be included in a single 
attractive to the home or school user. display with the total area of each pie showing the 


relative total values. Pie charts can be 2D or 3D witha 
Acorn User March 1992 wide choice of other options. 


Experimental Data 


Vertical and horizontal bar charts in 
six different varieties giving a total of 
12 different styles. 


Ela sed Time minutes 


Polar graphs (see left) can be 
plotted from mathematical polar 
equations or from data supplied 
by the user. In the latter case up 
to six data sets can be plotted on 
the same polar graph. 


Experimental data can be plotted and a 
choice of lines of best fit selected (straight 
line right, power bottom left, exponential 
bottom right. Equations and regression co- 
efficients are displayed for reference. 


by Fea Wa Ay Wy at We eg Sp ON Oe 


Chartwell is supplied with Outline Font Manager and Swiss-B outline font, a full reference manual with a tutorial section. The disc includes 
demonstration data and graph files. Members’ price £24.95 +p&p. Code PCHWb. 
RISC Developments Ltd. 117 Hatfield Rd, St..Albans, Herts AL14JS Tel. 0727 40303 Fax 0727 860263 


The 80 Column 


Our regular round-up of all things relating to printers, compiled by Alan Wrigley 


ne of the problems of a short column is 

lack of space when addressing a 
complex topic. Such is the case with RISC 
OS printer drivers, which appear to cause a 
considerable amount of grief to many 
readers. Although we have covered this 
subject a number of times in the 80 Column, 
there is still a great deal of confusion about 
how to use and modify them. We are 
currently planning something more 
substantial on this topic, so if you are having 
difficulties with printer drivers, all will soon 
be revealed. 


In the meantime, however, some 
confusion exists about November’s 80 
Column (Volume 5 Issue 1), in which I gave 
some information about setting up 
PrinterDM for use with a Canon BubbleJet. 
The data was tested on the BJ-10e, although 
I had understood that the newer models 
(BJ300 and BJ330) were software compatible 
with the BJ-10e. However, Mr A.F. Taylor 
has written to say that the information 
published does not work on his BJ300. In 
fact, the BJ300 has an Epson LQ850 
emulation, which the BJ-10e does not, and 
so it is more convenient to use the LQ850 
definition which is already present in 
PrinterDM as supplied by Acorn. This does 
take longer to print since it is an interlaced, 
two-pass mode, but Mr Taylor has sent 
some samples printed using both this 
emulation and the IBM 360x360 single-pass 
emulation, and the print quality from the 
Epson emulation appears to be far superior. 


Incidentally, my comment that some 
earlier printer drivers for the BubbleJet 
could only produce 360x180 resolution was 
aimed at the printer driver, not the printer. It 
is perfectly possible for all the BubbleJets to 
produce 360x360, but the printer driver had 
been incorrectly written. 
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DIRECT LASERS 

You may have seen references in 
magazines and adverts to so-called 600 dpi 
direct laser printers. In fact, these printers 
cannot produce true 600 dpi output, since 
they use print engines which were not 
designed for this resolution. These “high- 
resolution” direct lasers achieve their aim by 
spacing the dots more closely than the 300 
dpi at which the engines were designed to 
work, but the actual size of each dot is still 
1/300” and cannot be reduced below this 
size. Technology is still advancing rapidly in 
the world of printers, and true high- 
resolution lasers are probably not far away, 
but in the meantime some of the 
manufacturers of “high-resolution” direct 
lasers have agreed that they will in future 
refer to the breed as “pseudo 600 dpi” to 
avoid confusion. 


One of the companies concerned, 
Calligraph, has just released a new ArcLaser 
model based on the Qume Express. This is a 
pseudo 600 dpi model with dual paper bins, 
operating at a rapid 12 pages per minute. It 
is driven by the same ArcLaser software as 
the company’s existing models, and will 
retail at £1761.32 inc. VAT, with discounts 
for educationaltpurchasers. 


BASIC LISTINGS ON THE DESKJET 
by Richard Ribchester 

If you attempt to list Basic programs on 
the HP DeskJet 500 printer with its DIP 
switches set as supplied (all down), or to 
print data output from Basic programs 
using VDU2, the printer “Busy” light flashes 
and no output is printed until a form feed is 
activated, at which point all the output is 
overprinted on one line. Setting the Carriage 
Return Definition DIP switch A7 on the 
printer to Up overcomes this problem. aU 
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ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


lf you have written any programs, completed or not, then we would like 
to hear from you. 


lf you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


If you have the ability fo program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


If you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 
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Part 5: Loading data by RAM transfer 


by Mike Ironmonger 


his month we round off the series with a 

look at the loading of files directly from 
other applications via RAM. This process 
starts when a DataSave message is sent to 
our application giving details of the file to 
be transferred. 


block+20 destination window handle 
block+24 destinaton icon handle 
block+28 destination x co-ordinate 
block+32 destination y co-ordinate 


block+36 estimated size of data 

block+40 file type of data 

block+44 leafname of file 
(zero-terminated) 


Figure 1. DataSave message block 


To transfer the data via an intermediate 
file, we would reply with a DataSaveAck 
message quoting the filename 
‘<Wimp$Scrap>’, and the data would then 
be transferred via this file. However, to 
transmit the data via RAM we reply instead 
with a RAMFetch message indicating a 
buffer into which the sender can transfer the 
data. One of two things will then happen. 


If the sender is incapable of transferring 
the data via RAM it simply ignores the 
RAMFetch message. The Wimp will then 
return the message to us via reason code 19, 
and we default to the <Wimp$Scrap> 
method of transfer. 


If the sender can transfer the data via 
RAM it copies the data into our buffer and 
sends us a RAMTransmit message 
indicating how many bytes it copied into 
the buffer. If the buffer is full, we assume 
that there’s more data to come, and send 
another RAMFetch message. The sender 
then transfers more data, replies with a 
RAMTransmit message, and this process 
continues until all the data has been 
transferred - i.e. until the sender returns an 
unfilled buffer. 
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BUFFER SIZE 

The only problem with the above 
protocol is the question of how large a 
buffer to use for the transfer. In the 
Programmer's Reference Manual, Acorn 
states that the size of the buffer can be based 
upon the estimated size of the data from the 
DataSave message, but that the receiver 
should be prepared for more data to actually 
be sent. 


Basically, this means that you're free to 
use any size of buffer you wish, as long as 
you can extend the buffer if necessary. I 
recommend a buffer which is at least one 
byte larger than the estimated size from the 
DataSave message. The reason for the extra 
byte is so that if the estimated size is correct 
(as it should be for most applications) the 
first transfer won't fill the buffer and hence 
the whole transfer process will be completed 
as quickly as possible in one stage. 


Whatever size buffer you use, if it’s filled 
by the sender another question arises - how 
much do you then expand it by? There are 
no guidelines for this, so I inspected some of 
Acorn’s system applications. Edit extends its 
buffer by 4000 bytes, Paint by 256 bytes, and 
Draw by 1024 bytes, so take your pick. If 
you run out of memory for the expansion 
you should abort the transfer by not sending 
a RAMFetch message, and report a ‘Transfer 
aborted, out of memory’ error. 


Unfortunately for Basic programmers, the 
whole question of buffers and their expansion 
causes a problem because of the inflexibility 
of Basic’s memory management. A typical 
buffer created by a DIM statement can’t be 
expanded, and the memory it uses can’t be 
freed for use in another buffer. You may also 
simply not have enough memory available 
for the required buffer. A solution to both 
these problems is to expand your Wimp slot 
and use the memory above the program as a 
buffer. However, this is a topic in itself, and is 
beyond the scope of this article. 
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EXAMPLE PROGRAM 

An example of the above transfer 
protocol is provided by the program listed at 
the end of this article. To keep the program 
short, it only loads data directly from other 
applications via RAM. It should be run with 
a minimum Wimp slot of 24K, and it installs 
itself on the icon bar. When a file is dragged 
onto its icon from an application that can 
transfer via RAM, the file will be transferred 
directly to the program. An error box will 
then appear showing the first 100 printable 
bytes of the file. 


I've simulated an expanding buffer in 
the program by dimensioning a block of 10K 
and only using the first 1K of this as the 
buffer, so that expanding the buffer is easy. 
This goes against the earlier 
recommendation for the buffer size, but it 
allows three cases of transfer to be 
demonstrated: 


A file of 1K or less will be transferred in 
one go. 

A file of between 1K and 10K will be 
transferred in several stages. 

A file of over 10K in length will produce 
an out of memory error. 


PROGRAM DETAILS 

First note that when a DataSave 
message is received, line 280 calls 
PROCdata_save_received. This initialises three 
variables, starting with sending_task%, 
which is obtained from the DataSave 
message block. Then comes buffer_addr% 
and buffer_length%, which describe the 
buffer into which the data is to be 
transferred. Finally, the procedure 
PROCrequest_data is called. 


PROCrequest_data 

This procedure sets up the block for the 
RAMFetch message, and line 630 sends it as 
a UserMessageRecorded (number 18). If the 
sender can transfer the data via RAM it does 
so and replies with a RAMTransmit 
message, whereupon line 290 calls 
PROCram_transmit_received. 


PROCram_transmit_received 
This first obtains the number of bytes 
that were transferred into the buffer, and 


then adds that figure to buffer_addr% in 
preparation for the next stage of the transfer 
(if there is one). Line 430 then checks 
whether the buffer is full. 


If the buffer is full, there’s more data to 
come, and first section of the IF-THEN- 
ELSE is executed (line 440). A real program 
would have to extend the buffer at this 
point, but in the example we need only 
check whether the 10K has been used up 
yet. If it hasn’t, PROCrequest_data is called, 
otherwise an out of memory error is 
reported. 


If the buffer isn’t full, the transfer is 
complete, and the second section of the IF- 
THEN-ELSE is executed. Line 460 
calculates the total number of bytes that 
have been received, and then lines 470 to 
510 create a completion string which is 
reported by line 540. 


PROCram_fetch_not_acknowledged 

If a RAMFetch message isn’t replied to, 
it’s returned by the Wimp to the program 
via reason code 19, and line 190 calls 
PROCram_fetch_not_acknowledged. This 
performs one of two actions depending on 
whether any data has been received yet 
(checked by line 670). If no data has been 
received, the program should default to 
the <Wimp$Scrap> method of transfer, 
although it simply indicates this with an 
error message (line 680). If some data has 
been received, the program abandons the 
transfer simply by not sending another 
RAMFetch message. Note that no error is 
reported because in this case that’s the 
responsibility of the sender. 


This concludes our series, but for Wimp fans we 
will be starting a Wimp library next month. This 
will aim to build up a set of library procedures 
and functions to reduce the legwork involved in 
writing Wimp-based programs. 
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60. REM Program 
70 REM 
80; 
$0 ON ERROR PROCerror (ERR, REPORT$+" a 
t line "+STRSERL) : END 
100 PROCinitialise 
110 ON ERROR PROCerror (ERR, REPORTS) 
4) 
130 REPEAT 
140 SYS ‘Wimp_Poll*,&33,block$ TO reas 
on’ 
150 CASE reason$ OF 
160 WEEN 6 : SYS "Wimp_CreateMenu',,m 
enu$, !block$-64,140 
i70 WHEN $ : IF !block%=0 quitt=TRUE 
180 WHEN 17,18 : PROCreceive_message( 
plock$!16) 
i190 WHEN 19 : IF block$!16=6 PROCram_ 
fetch_not_acknowledged 
200 ENDCASE 
210 UNTIL quit® 
220 SYS *Wimp_CloseDown" 
230 END 


Subject to Copyright 
Not Public Domain 


250 DEF PROCreceive_message (message) 
260 CASE message’ OF 

270 WHEN C : quit$=TRUE 

280 WEEN 1 : PROCdata_save_received 
290 WEEN 7 : PROCram_transmit_receive 


309 ENDCASE 
310 ENDPROC 


330 DEF PROCdata_save_received 
340 sending_taskt=block$!4 

350 buffer_addrt=buffer? 

360 butfer_lengtht=1024 

370 PROCrequest_data 

380 ENDPROC 


400 DEF PROCram_transmit_received 

410 bytes_receivedt=block$!24 

420 puffer_addr%+=bytes_receiveds 

430 IF bytes_received$=buffer_length’ 
THEN 

449 IF buffer_addr$<end_of_buffer% PR 

Crequest_data ELSE ERROR 1,"Transfer ab 
orted, out of memory." 

450 ELSE 

460 total_bytes%=buifer_addrt-buffer$ 

470 S=totai_bytes$:IF S%>i00 S$=100 

480 textS="File transferred: " 

499 FOR ptr#=0 TO $%-1 
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500 IF buffer$?ptr$>31 text$+=CERS (5 
uffer’?ptr%) 

510 NEXT 

520 !block%=1 

530 $(block#+4)=text$+CHRSO 

540 SYS *Wimp_ReportError", block3,1," 
WimpDemo" 

550 ENDIF 

569 ENDPROC 


580 DEF PROCrequest_data 

590 block$!12=block$!8 

600 block$!16=6 

610 block$!20=buffer_addr% 

620 block$!24=buffer_lengtht 

630 SYS "Wimp_SendMessage’,18,block%,s 
ending_tesk% 

640 ENDPROC 

650 ;: 

660 DEF PROCram_fetch_not_acknowledgeca 

670 IF buffer_addrt=buffer% TEEN 

680 ERROR 1,*Sender can't transfer vi 
a RAM, abort to <wWimp$Scrap> method. * 

690 ELSE i 

700 REM transfer aborted, sender repo 
rts error 

710 ENDIF 

720 ENDPROC 

730 : 

740 DEF PROCerror(!dlock3,$ (blockt-4) } 

750 SYS "Wimp_ReportError", block%,1,"W 
impDemo" 

760 ENDPROC 

770 : 

780 DEF PROCinitialise 

790 DIM block$ 999,menu$ 123 

800 SYS "Wimp_Initialise*®,200,&4B53415 
4,"WimpDemo" TO ,my_task® 

810 quit3=FALSE 

820 DIM buffer 10240 

830 end_of_buffer$=buffer%+10239 

B40 : 

850 Be=block’ 

860 !B$=-1:B$!4=0:Be!12=68 

870 Be!8=0:B3!16=68:BS!20=2 

880 $(B%+24)="!WimpDemo* 

890 SYS *Wimp_CreateIcon", , BS 

900 : 

910 M&=menu%:SM%="WimpDeno" 

920 M¥!12=&70207 :M$!16=96 :M%!20=44 

930 M!24=0:M$!28=£60:M$!32=-1 

940 MB!36=&7000021:5 (M3+40) ="Quit" 

950 ENDPROC 


61 


Technical Queries 2 


Alan Wrigley presents a further round-up of your 
questions about Wimp programming. 


Dear Sir 
| have created a window using FormEd 
which contains several icons in which | wish 
to display sprites. | have loaded the sprites 
Into a sprite area within my program, but I 
cannot work out how to get them to 
appear in the window. The icons are all 
indirected, so | have tried to use 
Wimp_SetlconState to insert the pointer to 
the area after the template Is loaded in, but 
the sprites do not appear on screen, 
Dragging the sprite file into FormEd while 
creating the window displays them with no 
problem. What am | doing wrong? 

Mark Cummins 


The only parts of an icon definition which 
can subsequently be altered are the icon 
flags. If the icon is indirected you can also 
alter the data in the indirected buffer, 
because this is not part of the icon definition 
block. However, the pointer to this buffer is 
part of the block and cannot therefore be 
changed. This is why you can change the 
text in an indirected icon, because you are 
altering the contents of the buffer, not the 
pointer itself. 


Unfortunately, the only way to achieve your 
objective is for the icon to be created from 
within the program and not from the 
template file. You could do this by defining 
the rest of the window with FormEd, then 
adding the required icons to the window 
once the template has been loaded and the 
window created. A useful way to avoid 
having, to calculate the co-ordinates by hand 
is to drag the original template file into the 
FormPrint utility on the RISC User Wimp 
Programmer's Toolkit disc, and make a note of 
the data before deleting the icons from the 
template. 


Alternatively, you could still use your original 
template, but delete and immediately recreate 
the required icons from within the program. 
This would be done as follows: 
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!block$=whandleé: block! 4=ihandlet 
YS "Wimp_GetIconState",,block® 
YS “Wimp_DeletelIcon’, ,blockt 
block! 4=-whandlet:blockt! 32=spritearea’ 
SYS “Wimp_CreateIcon", ,blockt+4 TO inandies 
where spritearea% is the sprite area in which 
your sprites are stored. 


ty Up 


It is a good idea to load sprites into your 
own area, as you have done, rather than 
simply putting them all into the !Sprites file 
and allowing them to be loaded into the 
Wimp sprite pool. The latter method is the 
lazy way to do it and results in memory 
being used up, which cannot be reclaimed 
once the application is terminated. It is not 
uncommon to find that after opening up a 
few directory viewers containing 
applications, the sprite pool has grown by 
100K or so - a lot of memory on a 1 Mbyte 
machine. 


Dear Sir 
When displaying a window of data in a 
grid, | would like to be able to move from 
cell to cell using the keyboard. | have given 
the window the Input focus by opening a 
writable icon, but as soon as this is done 
the Wimp stops me reading the left and 
right cursor keys as it deals with these 
automatically. | have tried to stop this by 
using 2 validation string, but how can ! 
exclude keys that don't have a symbol? 
Can you help? 

B.W. Messer 


There is a very simple way to do this, which 
involves nothing more than setting one bit of 
the window flags. This is bit 12 and is 
usually referred to as the “hot keys” bit. If 
this bit is set, then whenever the window is 
open all unclaimed key presses will be 
passed to the task which owns that window. 
You must be aware, of course, that if the 
caret is currently owned by another task, 
then all key presses will be offered to that 
task first. Also, if the caret is inside a 
writable icon then key presses such as left 
and right cursor, and the others described on 
page 1198 of the Programmers Reference 
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Manual, will be processed automatically by 
the Wimp. If you are using this method to 
detect these keys, therefore, you must not 
claim the input focus by opening a writable 
icon. 


Dear Sir 
1 am trying to create a menu which has a 
writable item longer than 12 characters, 
and | am having some difficulty in getting 
this to work, and in reading the text which 
has been typed in. | gather that this must 
be Indirected, but I'm not sure I fully 
understand what this term means. 

N. Jacobs 


Normally when an icon or a menu item is 
defined, a space in the definition is reserved 
for the text which is to appear in the icon. 
This space has to be a finite size, and so in 
the case of icons and menu items (which are 
in fact nothing more than icons themselves) 
a maximum size of 12 characters has been 
chosen. If you wish to display an icon with 
more than 12 characters of text, an 
alternative method has to be found, and this 
is where indirection comes in. The term 
simply means that, instead of the actual text 
being placed within the block defining the 
icon, a pointer to a text string elsewhere in 
memory is included in its place. This string 
can be very much longer if necessary, and 
more importantly, it can be read and written 
independently of any actions involving the 
icon itself. 


In the case of a writable menu entry, this 
must be indirected in any event, since it is 
not possible otherwise to read the text which 
has been typed in. This is because the 
contents of an icon cannot be changed once it 
has been created. However, the contents of 
the indirected buffer can be altered, while 
the icon pointer will still always point to the 
same place. 


To do this, you must first set aside a block 
long enough for the maximum text to be 
entered, Next you must notify the Wimp that 
this menu item is indirected, since otherwise 
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it will try to interpret the pointer itself as a 
text string. You do this by setting bit 8 of the 
icon flags as usual (note however that to 
declare the item as writable you use bit 2 of 
the menu flags rather than bits 12-15 of the 
icon flags as with other icons). Then you 
simply treat the menu item as any other 
indirected icon, where the 12 characters 
normally occupied by the text string are 
replaced by three 4-byte pointers: pointer to 
text buffer, pointer to validation string, and 
buffer length. The following piece of code 
taken from a menu definition illustrates this. 
The first item is a straightforward text item 
of less than 12 characters, while the second 
item is writable. 

menu%!28=0:menu%!32=-1 

menus! 36=&7009021:5 (menu$+40) ="Info" 

menu$!52=4:menu$!56=-1 

menus !60=&7009129 :menu$! 64=menuindblks 

menu$!68=-1:menu$!72=20 


The writable item is 20 bytes long (as 
declared at menu%!72) and is stored ina 
buffer at menuindblk%, so this must have 
been dimensioned first with: 
DIM menuindblk? i$ 

Bit 2 of the menu flags is set (at menu%!52), 
while bits 3 and 8 of the icon flags at 
menu%!60 are set (to centre the caret 
horizontally and set the icon as indirected 
respectively). There is in this case no 
validation string, so menu%!68 can be set to - 
1. If you need a validation string then you 
must place this in another buffer and put the 
pointer to this buffer at menu %!68. 


To read the text which has been entered into 
the writable icon, all you need is a statement 
such as: 

text $=Smenuincblkt 
You can also pre-define the text which will 
appear in the icon when the menu is opened, 
by writing to the buffer first, for example: 

Smenuindbl kt=pathnames 
You will often see this in save boxes, where a 
default filename or a full pathname is 
inserted into the writable icon before the 
dialogue box is opened. 

; AU 
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ARCSCAN Ill 
A tully customisable all-purpose reference finder for books, magazines and manuals. 
ARCSCAN Iti PROGRAM DISC CONTAINS THE FOLLOWING DATABASES: 


* RISC User Volumes 1, 2 and 3 * BEEBUG Volumes 1-9 

The Indexes to the following major Archimedes manuals: 
* Basic User Guide (Arthur) * Programmer's Reference Manual (Arthur) 
* RISC OS User Guide * RISC OS Basic Manual 


* RISC OS Programmer's Reference Manual * ANSI C Manual (Release 3) 

¢ Fortran 77 
SOME OF THE FEATURES ARCSCAN III OFFERS: 

* flexible keyboard search on any entry 
-¢ improved search logic - choice of 3 logical operators: OR, AND and NOT 
extended wildcard option 
dynamic memory management 
dedicated ARM code routines enabling rapid information retrieval 
finds displayed in a fast scrolling Wimp window 
fully user customisable P ; 
detailed manual and extensive on-screen help The on-screen help in action 
ARCSCAN LIBRARY DISC offers an index for Acorn User and Micro User magazines from January 1987 to date. The Library Disc 


will be regularly updated to include the latest issues, and upgrades will be available from RISC Developments. In the future we are 
hoping to add an index for A&B and Archimedes World magazines. 


WIMP PROGRAMMER S TOOLKIT 
Twelve powerful multi-tasking utilities, supported by a comprehensive manual - an essential aid to any programmer. 
SPYGLASS Select any running application and display in a window the contents of the 
memory allocated to it. 
WIMP DEBUGGER Debug Wimp-based programs while testing and running them. 
TEMPLATE EDITOR Acorn's FormEd for designing windows and icons. 
TEMPLATE FILE BROWSER View the contents of a template file. 
APPLICATION SHELL GENERATOR Create application directories, Obey files and their sprites, 
MENU EDITOR Create and edit Wimp menu structures for use in your own programs. 
WIMPAID Allows pointer, window and icon parameters to be displayed on screen. 
I}CONBAR SHELL GENERATOR Build simple multi-tasking programs very easily. 
DESKTOP FILE LOADER Allows you to load a program from the Desktop, rather than run it. 
ICON FLAG GENERATOR Calculate the value of icon flags. 
EASYWIMP Ready-made Wimp application shell to be used for the creation of single- 
window applications. 
WIMP MESSAGE MONITOR Monitors the Wimp polling system. 
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POLYGLOT 


A fully multi-tasking application which provides fast and easy access to foreign 
language character sets when using word processors, DTP packages, spreadsheets, 
databases or indeed any other multi-tasking packages. 


Open a window for any specified language, and this will display all characters which are 
impossible or difficult to obtain from the lontoack for example, accented characters in 
French or umlauted characters in German. Select any one of these characters with the 
mouse and it will automatically be inserted in your document. 


WHY POLYGLOT IS BETTER THAN ANY OTHER SYSTEM 

See all the characters you require in a window in both upper and lower case; no need for 
keyboard overlays 

No need to set your keyboard to a foreign standard to obtain appropriate foreign characters. 
Work with different languages or alternative character sets at the same time. 

Tailor and customise the package to your own needs. ren 
Use any character set, alphabet and even scientific characters (provided your fonts support Eo 


these}. PolyGlot language windows 
RISC DEVE! C USER MEMBERS 
Code Product Members Price inc VAT Code Product Members Price inc VAT 
0090b Star/Epson Colour Printer Driver 15,86 PAOMa ArcOmnibus Games Disc 9.95 
0091a Ovation font upgrade 8.81 PAS3b ArcScan III 14,95 
0092b TypeStudio 47.59 PAU3b ArcScan I!| upgrade 4.75 
0093¢ Hearsay Il 79.31 PALla ArcScan Ill Library Disc 7.95 
0094b Hard Disc Companion II 47,59 PALUa ArcScan Ill Library Disc upgrade 3.45 
0095b DeskJet 500C Printer Driver 15.86 PDAla Desktop Applications | 9.95 
0096b Desktop Thesaurus 20.09 PWPTb Wimp Programmer’s Toolkit 14.95 
0100b Mastertile Archimedes 16.86 PEDTb DeskEdit 19.95 
0102a DFS reader 10,12 PGLTb PolyGlot 14.95 
0107c C Development System 80.72 PCHWb — ChartWell 24,95 
0108c Ovation 101.16 
O1l1b Outline Font Pack 1 50.57 P&P UK Europe Americas, Africa, Mid. East. Elsewhere 
O112c Hearsay II upgrade 17.63 3 100 : fa ‘ ei : 2 Pe 
0113b Hard Disc Companion II upgrade 41.13 . 0 5.0 3.5 
Oll4a Ovation Deno Die 5.00 ce £3.10 £ 6.50 £10.50 £11.50 


Postbag 


DIY HARD DISC INTERFACING 


I have been considering buying a hard disc for 
my Archimedes A3000 but have been put off by 
the ridiculously high prices for even small 20 Mb 
drives. Most suppliers I have contacted have been 
unhelpful, and some downright evasive when 
asked technical details of their interfaces/drives. 


I cannot believe there is such a great difference in 
drive types to make the Archimedes unique. 
Astan engineer, | believe it must be possible to 
buy an interface from an approved Archimedes 
dealer and couple it to an inexpensive 
commercially available high capacity drive unit 
such as those made by Seagate or Fujitsu. 


As it may prove an expensive experiment, | 
wondered if any RISC User members have 
already done this and would care to enlighten the 
rest of us? 

John Scott Patterson 


Any Input from readers will be welcome and 
featured in our new reader pages (see this 
month's editorial). 


WIMP FUNCTION/PROCEDURE 
LIBRARY 


By far the majority of programs now published in 
RISC User run under the Wimp, making listings 
longer than they would otherwise be. If all such 
programs were to use a common Wimp procedure 
library, listings might be up to 50% shorter. 
Regular contributors clearly use their own 
procedure libraries, but these are not compatible 
with one another. RISC User should take the 
plunge, publish a Wimp procedure library, and 
insist that contributors make maximum use of it. 

R.E.Mawhood 


Mr.Mawhood's letter is very timely as we 
have already been planning to do just what 
he suggests, and the first instalment will be 
appearing in the May issue of RISC USer. If 
other readers can contribute to this library 
then we would like to hear from them, but It 
would be advisable to phone first to check 
our more detailed requirements. 


REQUEST FOR GRAPHICS 


] am currently writing a book Graphics on the 
ARM Machines to be published by Dabs Press. 
Firstly, | wish to describe as much relevant 
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current software as possible. Full credits will be 
given, and all companies whose products are 
mentioned will be listed in an appendix. There 
may be readers who have developed software 
which they intend to market who might be 
interested to see it reviewed in the book. This 
invitation is open to anyone. 


Secondly, we hope to inciude a full-colour section 
to reproduce attractive examples of the graphics 
described in the book, though this is not yet 
definite. If any readers have any examples, or 
know of anyone else who has, then I would like to 
hear from them. Obviously the originator and 
any software used will be credited. 

Roger Amos 


If any readers can help they should contact 
Roger directly at 16 Murray Road, Rugby 
CV21 3)N. Roger has recently completed a 
book on DTP for Dabs Press (see News 
pages), and has also undertaken work on the 
Ovation manual for RISC Developments. 
Please contact Roger directly, not through 
RISC User. 


A SHOCKING EXPERIENCE 


I use my A410 mostly at work in a busy 
electronic workshop for database and letter 
writing. For this reason, the Archimedes and 
monitor are left switched on all day. As you can 
imagine the screen attracts a lot of dust and 
requires frequent cleaning. 


Yesterday I switched the machine off and sprayed 
the screen with RadioSpares’ Aerosol Foam 
Cleanser (stock code 551-873). As the monitor 
was very dirty I gave it a slightly more generous 
spray than usual, and was a little shocked when 
the screen burst into flames on application of the 
yellow duster! 


A large static discharge ignited the foam and 
gave me quite a shock. No harm was done, other 
than to my pride, but other readers might be 
interested in this tale just in case they get caught 
out too. 

Tom Waller 


We spoke with Tom Waller who explained 
that it was only the foam that ignited leaving 
his monitor (and himself) unharmed. A 
cautionary tale indeed! aY 
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Hints & Tips... Hints & Tips 


Please do keep your hints and tips coming in - don't 


before transferring it to the PC by using the 


forget, we pay for any that we publish. “Find” option in Edit. We have to replace a single 
linefeed by a carriage return and then a linefeed, 
so to do this select the “Magic Characters” option 
UNTITLED DRAGGING in the “Find Text” dialogue box, enter \x0A in 
Mark Moxon the “Find” icon, enter \xOD\x0A in the 


If you create a window with no title bar, it will 
normally be unmoveable. However, it is very 
easy to tell the Wimp to allow movement of the 
window. When the Wimp Poll returns a mouse 
click over the window (reason code 6) use the 
following (to detect a click with Select for 
example): 

WHEN 6:IF block®!8=4 AND block$!12=wind 

@ TEEN PROCdrag 
and then simply use the following procedure to 
enable the window to be dragged: 

DEF PROCdrag 

block$!4=wind$ 

SYS “Wimp_GetWindowOutline",, Dlock#+4 

tblock$=wind®:block#!4=1 

SYS "Wimp_DracBox*, ,block$ 

ENDPROC 
where wind% is the window handle of the 
window to be dragged. The way this works is 
simply to initiate a dragging operation on the 
window (whose co-ordinates are found with SYS 
“Wimp_GetWindowOutline”) with drag type 1 
(drag window position) when the mouse is 
clicked over the window area. An example of the 
use of this code is given in the Desktop Character 
Rulers application elsewhere in this issue. 


“Replace” icon, and click on “Go”. When the first 
occurrence is found, click on “End of File 
Replace”, save the file and transfer it over to the 
PC. 


Another problem that may occur when 
transferring text files to the PC is that multiple 
spaces should be replaced by tab characters 
(hex code &09). There are two solutions to this, 
one using RISC OS 2 Edit, and the other using 
RISC OS 3 Edit or DeskEdit (which both have 
much enhanced searching, facilities). In RISC 
OS 2 Edit, the solution is to place a unique 
character where you will want a tab character 
to appear, and then use “Find” to replace this 
character with a tab character (specified by 
\x09 in “Magic Characters” mode), With RISC 
OS 3 Edit or DeskEdit the solution is much 
more comprehensive. The following method 
will replace 2 or more spaces with a tab 
character: Select “Wildcarded expressions”; Put 
A<spc>*%<spc> in the “Find” icon (where 
<spc> means a space); Put the caret in the 
“Replace” icon, click on the “Hex” button at the 
bottom right of the dialogue box, and type 09; 
finally click on “Go” and then “End of File 
Replace”. 


WORDWRAPPING CAUTION 
TEXT FILE CONVERSION TO PC Alan Wrigley 
Graham Kendal! Graham Carter's tip about wordwrap by default 


On the Archimedes, each line in a text file 
(created with Edit or saved from a DTP package 
as ASCII text, for example) is terminated with the 
linefeed character (hex code &0A). If such a file is 
transported over to a PC and loaded into a word 
processor then no serious problems will arise, 
but it can cause some strange effects (when 
formatting for example). The problem lies in the 
difference between the line termination 
characters - a PC uses two characters to terminate 
each line, namely a carriage return (hex code 
&0D) and then a linefeed. The solution is 
therefore to “massage” your Archimedes file 
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in DeskEdit (WP/DTP Volume 5 Issue 3) is very 
useful, but if you use this it will of course apply 
to all DeskEdit windows, including Basic 
programs, Obey files and so on. And since you 
should never edit Basic programs or Obey files 
with wordwrap on, you will need to turn it off 
manually in such cases, Having wordwrap on 
can cause problems with spaces on the ends of 
lines; for example if the line: 
Set MyApp$Dir <ObeySDir> 

has a space at the end, then the definition of 
MyApp$Dir will also include the space, which 
will give an error when MyApp$Dir is used. 
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You can, however, create a pair of Obey files to 
automate the process. You need one Obey file 
called wrap_on and one called wrap_off. The first 
should contain the line: 

Set DeskEditSOptions FQ 87 
and the second should contain the line: 

Set DeskEditSOptions FO B7 D 
(assuming you haven't edited the default options 
supplied in DeskEdit’s !Run file). Double- 
clicking on wrap_on will set the option for the 
next window opened to wordwrap on, and 
double-clicking on wrap_off will set it to 
wordwrap off - this is because DeskEdit looks at 
the value of DeskEdit$Options before opening a 
new window. 


OPENING DIRECTORIES IN RISC OS 3 
Alistair Clark 


A useful feature of RISC OS 3 is that if a directory 
viewer is opened while holding down the Ctrl 
key, the !Boot files of any applications it contains 
are not run. This can save an unnecessary delay if 
you only want to check the contents of a 
directory containing many applications. It will 
also help to stop any virus activity controlled 
from the !Boot file, allowing you to inspect files 
and directories in safety. 


FILLING IN PAINT 
David Spencer 


If a sprite is created in Paint with a transparency 
mask, then this is stored separately to the sprite 
itself. This means that each transparent pixel has 
a colour - it just isn’t displayed. 


Normally this doesn’t cause any problems, but 
there is one case where you can get caught out. 
If you create an area of adjacent pixels in a 
single colour and then split it into two by 
making some of the pixels transparent, you will 
appear to have two separate areas, However, 
now try filling one of the two areas with a new 
colour - the other one is filled too. This is 
because the fill routine just looks at the pixel 
colour, and not the transparency mask, and 
hence sees the two areas as a single joined area. 
Understandable, but most likely not what you 
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want, If this is going to be a problem, then the 
solution is to change each pixel to an unused 
colour before making it transparent. 


SHIFTY CHARACTERS 
Richard Head 


One point about the Acorn application Chars 
that may confuse some people is that if you 
need to enter a character into a writable menu 
entry or a save box, then clicking on the 
character window will remove the menu/box 
and will therefore make the placing of special 
characters in these icons impossible. However 
there is a documented feature of Chars (and the 
enhanced CharSel application supplied with 
Ovation) that allows this problem to be 
overcome - pressing the Shift key when the 
pointer is over one of the characters in the 
character window inserts that character into the 
keyboard buffer. This method will not remove 
any menu structures or non-permanent 
dialogue boxes. 


UPDATING SYSTEM MODULES BY 
DRAGGING 
Mark Moxon 


A number of people ring me up complaining 
that they have dragged the system modules off 
one of our discs into their master 
!System.Modules directory, but the applications 
on the disc will not run because of an out of 
date module, even if they have done a Reset 
and tried again. This problem often occurs 
because the module will have been dragged 
into a directory already containing a file with 
the same name (e.g. CLib), and unless the Force 
option is set for the copy command, the new 
module will not overwrite the old one, thus 
effectively not updating the shared resources. 
There are two ways around this - either delete 
the old module before dragging the new one to 
your master !/System.Modules directory, or set 
the F option in the system variable 
Copy$Options (look up Copy$Options in your 
User Guide). A further way round this problem 
is to use the SysMerge application from Acorn, 
which makes sure the latest versions of the 
modules are put in the master !System.Modules 
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EXPANSION BOARD FO 


FAX 
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FaxPack is a fax expansion board for the 
Archimedes range of computers 
allowing your computer to take on the 
job ofaconventional fax machine but 
with the benefits of being fully 
integrated into the Archimedes. 


FaxPack offers full background send and 
receive capability. You can senda fax simply by 
selecting the PRINT option fromany RISC OS 
application, with control returned in justa few 
seconds. FaxPack then proceeds to dial and 
send the fax while you carry on using the 
computer. 


Receiving faxes is also completely automatic. 
FaxPack will answer the phone and store the 
fax away on your disc while you continue to 
use the computer. Once received the fax can 
be viewed on screen (using a special 
anti-aliased display to improve on-screen 
readability) and printed. Any portion of the fax 
image can be saved asa conventional sprite. 
Alternatively FaxPack can be made to 
automatically print on receipt ofa fax, which 
witha LaserDirect printer, is completely 
automatic and in the background. 


Meee ROR CALM E-DLE § 


There are numerous advantages ofa 
computer based fax system over a 
conventional machine: 


U Very high quality, pixel perfect faxes - try 
sending a fax of 8pt text froma conventional 
fax machine! 


C) Since there is no need to print, then re-scan 
a document, FaxPack saves time, paper and 
money when sending faxes. 


Q) Rather than junk fax mail wasting your 
costly fax paper, you can decide to delete 
unwanted fax files before printing. 


L) By receiving and sending from the computer 
FaxPack offers a higher level of security than 
most conventional fax machines. 


LJ FaxPack allows electronic archiving of fax 
messages and is one step towards the truly 
paperless office. 


WJ FaxPack uses your standard Archimedes 
printer and so can print on plain paper rather 
than thermal paper. 


In addition FaxPack can be used asa data 
modem, to send and receive any Archimedes 
file or directory of files to other machines 
fitted with FaxPack. Because of the 9600 baud 
rate of fax systems and the use of data 
compression FaxPack is faster than practically 
all conventional data modems and permits 
background data transfer. 


FaxPack 
£299 + £10.00 carriage + VAT (£363.07) 


Computer Concepts Ltd 


Gaddesden Place, Hemel Hempstead, 
Herts, HP2 6EX. 
Tel: 0442 63933 Fax: 0442 231632 


APPROVED for connection to 
telecommunication systems specified 
in the insttuctions for use subject to 

the conditions set GUT them 


Personal Ads 


Jetpage Postscript Cartridge for Hewlett Packard 
Laserjet Ill, 35 Postscript fonts, compatible with DIP 
on Archimedes with Postscript driver £100 o.n.o. Tel. 
(0232) 457687 after 6pm. 


Archimedes A420/1, colour monitor, 2b RAM and 
20Mb St502 hard drive, only 16 months old, very good 
condition, Panasonic KXP-1124 pin printer, wall throw 
in some games, dust covers and other extras! The 
whole lot for £1,200! Ideal set-up for wordprocessing. 
Tel. (0707) 323032 eves, 


Star LC24-200 colour printer, perfect condition £175 
ono, Tel (0865) 864182. 


A3000 with 2Mb RAM upgrade, Philips C3833 
stereo colour monitor, Pres: monitor stand, system 
housing, 5.25" disc drive, disc buffer, 65Host DFS, 
podule case, latest PC emulator, covers, all manuals 
etc. As new, the perfect educational system £875. Tel. 
(0444) 454348 eves. 


Pres: 3.5" disc drive as new including fitting 
instructions, excellent condition only £45 o.n.o. Tel. 
(0444) 454348 eves. 


Sanyo 6PPM laser printer (emulates HPLIll) £400, 
A310 base unt with RISC OS £400, RICOH daisywheel 
printer £75, A3000 carrying case £15, parallel printer 
cable £5, Taxan 795 msync monitor £200, HP Deskjet+ 
printer £175, Philips colour monitor £120, Parallel 
printer cable £5, BeebDOS £20, BeebPC £20, 
WANTED: Low cost Archimedes system and/or A300 
disc buffer and/or RAM upgrade. Tel. (0483) 480632. 


Impression Junior (latest version 1.14) mint condition 
in original case, masters unused £50. Tel. (0532) 
653643. 


Games suitable for the Archimedes together with 
manuals; Chocks Away (mark Il) £12, UIM £10, White 
Magic 1 and 2 £8 each, Hostages £10, Professor 
Mariarti £8, Nevryon £12, Hoied Out £10, Apocalypse 
£13, Pandora's Box £18, E Type £18, inertia £11, 
Articulate £15, Quazer £8, Enter the Realm £18 & 
Saloon Cars £20. Tel. (0392) 55605. 


1Mb upgrade for A3000 £30, Tel. (0923) 823659. 


A310 with 4-slot , Manuals and plenty of 
software, £500 (£600 with std colour monitor), 


including discount vouchers towards RAM/ARM3 
upgrades, Acorn JP150 inkjet printer (brand new) 
£225, Citizen €120-D 9 pin dot matrix NLQ printer, 
£80, Armadilo A448 sampler card and sw £70. Tel. 
071-703 5675. 


RISC User bound issues vol.1 £7, vol.2 £9, vol3 £11. 
Tel, (0734) 791436. 


Minerva Graphbox (still boxed) £40, Lingenuity 
Hotlink Presenter £25, impression Il (still baxed) £100. 
Tel. (0293) 542288 eves & wiends. 


A3000 external 3.5" disc drive and interface £70 + 
postage, Tel. 061-247 1198 day (0204) 41459 eves & 
wiends. | would like to get in contact with anyone 
who is developing or using artificial neural 
networks for use with the Archimedes. ! can be 
contacted on the above numbers or by my email 
address. email DB90A00@uk.ac.manp.cs.sa 


Colpeel (o.prierbard 1 6 wey cae 
ink cartridges), includes new cartridges & new roll of 
japer, one year old only £300 (new house forces sale). 

ia a (0248) 835204 


83Mb Seagate external hard drive (cased), Serial 
Port SCSI interface for A3000 £400. Tel. (0303) 
872915 after 6pm. 


Archimedes 440, 53Mb hard disc, Taxan 770+, 
mubisync monitor, loads of software. Offers? Tel. 081- 
445 7875. 


RISC OS upgrade (from Arthur system) new £20, 
Psion Organiser Developer II original software ‘The 
Organiser Developer’ £15 0.n.0. Psion printer II four 
thermal paper rolls per box, 4 boxes £15 o.n.0. Psion 
Organiser Il ‘Diary Link’ original software £5. Tel. 
(0234) 856070. 


A310, 3.5* double floppy disc drive, all manuals, 
welcome discs, Archi mouse, RISC 05, PC emulator, 
expansion BUS with 10 card (user/analogue port), Zatch 
(boxed) £550, also BBC B, es feoos floppy disc drive, 
gaenes, Shark, Pipeline £200. Tel. (05255) 3382. 


System Delta+ (Minerva), in original packaging, 
unwanted gift £45. Tel, (0253) 67987 after 7pm. 


Acorn A3000 2Mb RAM, Philips stereo colour 
monitor, 49Mb SCSI drive, manuals and loads of 
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software, £900. Tel, (0782) 404816 day, (0782) 
314053 after 7.30pm. 


Star L24-200 colour printer bought 18/2/91, hardly 
used, replaced by Laser Direct £200 o.n.0, Tel. 081-440 
0096 eves. 


WANTED: E-Type, E-Type Designer, E-Type Extra 100 
miles, Deltacat joystick, also, Chocks Away Extra 
Missions disc. Write to; P.0.B. 1830, Limassol, Cyprus. 


Games; Zarch £5, Orion £4, PC Emulator £7, Pacmania 
£5, Chocks Away £8, Holed Out £8, Nevryon £6, Ist 
Word Plus release | £8, all are complete with discs and 
original manuals. Tél, (0752) 896077. 


Acorn Scientific workstation, BBC B & 
NS3200, 4Mb RAM, hard disc drive, single disc drive, 
streamer, KXP1081 printer, Fortran, C, Lisp, ISO Pascal, 
Basi, full manuals, offersipart exchange. Tel. 021-711 
2281 anytime. 


A310M, DTP software, PC Emulator (1.6), Render 
Bender, Genesis and games, all for £540, will split, Old 
PRMs £9, various computer magazines, EMR sound 
sampler £60, Watford video digitiser £75, Acorn colour 
Monitor £110, Tel, 061-973 0529 after 6pm. 


WANTED; = Multisync monitor for use with modes 0- 
21, 24-28 and SVGA if possible (must be cheap). Tel. 
061-973 0529 after 6pm, 


Scanlight A6 scanner, brand nevi, unwanted gift, stil 
in box £125 o.n.o. Tel, (0270) 67975 eves. 


Amstrad ALT386 laptop will exchange for 
Archimedes, Laser Direct etc. CC256 grey scanner 
£125. Tel, (0263) 70669. 


Acornsoft Lisp for the Archimedes, excellent 
condition, £95 o.n.o. Tel, (0388) 834186, 


Archimedes A310, Philips 8833 colour monitor, 
manuals, boxes, some software £650. Tel. (0792) 
404331. After 6pm. 


Potential purchasers are advised to insist 
that it is the seller's responsibility to 
ensure that goods arrive with the 
purchaser in a fit state as described. In 
the event of in transit, contact 
the seller before taking further action. 
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Hearsay IT is the latest development of the highly acclaimed Archimedes 
communications package, Hearsay. It is multi-tasking and RISC OS 
compliant, and provides more advanced features in an even easier-to-use 
package. It is ideal for use with Prestel, Telecom Gold, Campus 2000 and 
Compuserve, and also provides very high quality VT320, VT102, VT52 
and Tektronix 4105 Colour terminal emulations for direct connection to 
mini and mainframe hosts. 

Hearsay Il also gives access to Minitel systems such as the French 
Teletel service, and includes Xmodem, Ymodem, Zmodem & Kermit file 
transfer, comprehensive script language and auto-dial number directory. 
Most popular modems are supported, including Hayes, DTI and SM2400. 
Tt does everything we want, and is a pleasure to use.’ ARCHIVE Jan 92 
Members Price £67.50 + VAT Site Licence £350 + VAT 
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TypeStudio 


TypeStudio is a complete text manipulation package ideal for producing 
professional quality adverts, posters, banners, logos, letterheads etc. 
Drawing tools allow lines and curves to be drawn, along which text can 
be flowed to follow any shape. Pairs of lines may be linked to create 
shapes into which text and Draw files may be moulded. A wide range of 
special effects are available, including: shadow, slant, mirror, 3D etc. 
Designs may be printed directly from TypeStudio, or exported as 
Draw files to other applications. The package includes 7 fonts and a 
AA on 64-page user guide containing many worked examples. 
! i ‘Of the three (packages), TypeStudio is the most comprebensive. All of the 
tools you are likely to need are included and there is no need to use any 
other application with it.’ ACORN USER Mar 92 
Members Price £40.50 + VAT Site Licence &75 + VAT 


yNANTS Sow 


¢ 
y 


Hard Disc Companion II 


Version II of this hard disc backup program is a vastly enhanced version 
oe of the original program, re-written to make it twice as fast and even 
CLC + easier to use. It provides a structured approach to the backing up of hard 
ce THT eomintei(—] Serve drives, and the recovery of files in the event of disc failure or accidental 
zat 1 arn file deletion. Both Full and Incremental backups are supported, and the 
files to be backed up or ignored may be specified using simple drag 
operations, The entire backup specification may be saved in a script file 
for use at a later date. 

Hard Disc Companion Il uses an efficient compression system to 
backup as much data as possible onto as few floppies as possible 
without increasing the backup time. Separate applications are included 
to restore entire backups or indiyidual files. 

Members Price £40.50 + VAT Site Licence £195 + VAT 


Colour Printer Drivers 


The PrinterDJ printer driver produces near laser quality output 

from the highly acclaimed Hewlett Packard DeskJet 500C colour 
printer. It is a release 2 driver and supports 75 X 75, 150 x 150 and 300 x 
300 dpi print resolutions in monochrome, grey scale and full colour 
modes. Release 3 driver for the A5000 and RISC OS 3 available soon. ( xX 


Davalo 


Members Price £13.50 + VAT Site Licence £75 + VAT 
The PrinterLC driver is the approved printer driver for Star colour dot- 
matrix printers, It is suitable for both 9-pin and 24-pin colour printers e.g. 
LC24-200, LC-200, XB24-10 and LC-10. PrinterLC is a release 2 driver, 
supporting various print resolutions from 60 x 72 dpi to 360 x 360 dpi 
depending on the printer model. Also suitable for many Epson and NEC 


cp 
colour printers. pol 
(at 


Members Price £13.50 + VAT Site Licence £75 + VAT 


RISC Developments Ltd. 117 Hatfield Road, St. Albans, Herts. AL1 4JS Tel. (0727) 40303 Fax. (0727) 860263 


